Skip to main content
GET
/
api
/
external
/
issuance
/
credentials
/
{batchId}
curl --request GET \
  --url https://api.getrecord.in/api/external/issuance/credentials/batch_1779353381048_e3ixqz \
  --header 'Authorization: Bearer sk_test_your_token_here'

{
  "success": true,
  "message": "Credential batch fetched successfully",
  "data": {
    "batchId": "batch_1779353381048_e3ixqz",
    "programId": "prog_1779172339924_j3pr93",
    "batchName": "May 2025 Cohort",
    "orgId": "org_1779085658651_hmhfv5",
    "mode": "test",
    "status": "issued",
    "recipients": [
      {
        "recipientId": "rec_1779353381048_ab12cd",
        "name": "Alice Johnson",
        "email": "alice@example.com",
        "credentialUrl": "https://app.getrecord.in/credential/rec_1779353381048_ab12cd"
      },
      {
        "recipientId": "rec_1779353381049_ef34gh",
        "name": "Bob Smith",
        "email": "bob@example.com",
        "credentialUrl": "https://app.getrecord.in/credential/rec_1779353381049_ef34gh"
      }
    ],
    "issuedAt": "2025-05-21T08:09:41.048Z"
  }
}

​
Overview

Returns complete batch details including every recipient and their unique credentialUrl. Use batchId values from the Issue Credentials or List Credential Batches response.
No request body required. Pass the batchId as a path parameter.

​
Path Parameters

ParameterTypeRequiredDescription
batchIdstringYesThe batchId returned from Issue Credentials or List Batches

​
Response Fields

FieldTypeDescription
batchIdstringUnique batch identifier
programIdstringProgramme this batch belongs to
batchNamestringName given to this batch
orgIdstringOrganisation
modestring"live" or "test"
statusstringBatch status
recipientsarrayArray of issued credentials
recipients[].recipientIdstringUnique credential ID per recipient
recipients[].namestringRecipient full name
recipients[].emailstringRecipient email address
recipients[].credentialUrlstringPublic URL to view the credential
issuedAtstringISO 8601 timestamp

​
Error Codes

CodeHTTPDescription
UNAUTHORIZED401Token missing or invalid
NOT_FOUND404batchId does not exist or belongs to another org
curl --request GET \
  --url https://api.getrecord.in/api/external/issuance/credentials/batch_1779353381048_e3ixqz \
  --header 'Authorization: Bearer sk_test_your_token_here'

{
  "success": true,
  "message": "Credential batch fetched successfully",
  "data": {
    "batchId": "batch_1779353381048_e3ixqz",
    "programId": "prog_1779172339924_j3pr93",
    "batchName": "May 2025 Cohort",
    "orgId": "org_1779085658651_hmhfv5",
    "mode": "test",
    "status": "issued",
    "recipients": [
      {
        "recipientId": "rec_1779353381048_ab12cd",
        "name": "Alice Johnson",
        "email": "alice@example.com",
        "credentialUrl": "https://app.getrecord.in/credential/rec_1779353381048_ab12cd"
      },
      {
        "recipientId": "rec_1779353381049_ef34gh",
        "name": "Bob Smith",
        "email": "bob@example.com",
        "credentialUrl": "https://app.getrecord.in/credential/rec_1779353381049_ef34gh"
      }
    ],
    "issuedAt": "2025-05-21T08:09:41.048Z"
  }
}