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

{
  "success": true,
  "message": "Credential batches fetched successfully",
  "data": [
    {
      "batchId": "batch_1779353381048_e3ixqz",
      "programId": "prog_1779172339924_j3pr93",
      "batchName": "May 2025 Cohort",
      "orgId": "org_1779085658651_hmhfv5",
      "mode": "test",
      "status": "issued",
      "recipientCount": 2,
      "issuedAt": "2025-05-21T08:09:41.048Z"
    }
  ]
}

​
Overview

Returns a summary list of every credential batch your organisation has issued. To see the full recipient list for a batch, use Get Credential Batch.
No query parameters or request body required. Authentication via Authorization or X-Api-Key header.

​
Response Fields

FieldTypeDescription
batchIdstringUnique batch identifier
programIdstringProgramme this batch belongs to
batchNamestringBatch label
orgIdstringOrganisation
modestring"live" or "test"
statusstringBatch status
recipientCountnumberNumber of credentials issued in this batch
issuedAtstringISO 8601 timestamp

​
Error Codes

CodeHTTPDescription
UNAUTHORIZED401Token missing or invalid
curl --request GET \
  --url https://api.getrecord.in/api/external/issuance/credentials \
  --header 'Authorization: Bearer sk_test_your_token_here'

{
  "success": true,
  "message": "Credential batches fetched successfully",
  "data": [
    {
      "batchId": "batch_1779353381048_e3ixqz",
      "programId": "prog_1779172339924_j3pr93",
      "batchName": "May 2025 Cohort",
      "orgId": "org_1779085658651_hmhfv5",
      "mode": "test",
      "status": "issued",
      "recipientCount": 2,
      "issuedAt": "2025-05-21T08:09:41.048Z"
    }
  ]
}