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"
}
}
Issuance API
Get Credential Batch
Retrieve full details of a credential batch including all recipients and their credential URLs.
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 uniquecredentialUrl. 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
| Parameter | Type | Required | Description |
|---|---|---|---|
batchId | string | Yes | The batchId returned from Issue Credentials or List Batches |
Response Fields
| Field | Type | Description |
|---|---|---|
batchId | string | Unique batch identifier |
programId | string | Programme this batch belongs to |
batchName | string | Name given to this batch |
orgId | string | Organisation |
mode | string | "live" or "test" |
status | string | Batch status |
recipients | array | Array of issued credentials |
recipients[].recipientId | string | Unique credential ID per recipient |
recipients[].name | string | Recipient full name |
recipients[].email | string | Recipient email address |
recipients[].credentialUrl | string | Public URL to view the credential |
issuedAt | string | ISO 8601 timestamp |
Error Codes
| Code | HTTP | Description |
|---|---|---|
UNAUTHORIZED | 401 | Token missing or invalid |
NOT_FOUND | 404 | batchId 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"
}
}
⌘I