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

{
  "success": true,
  "message": "Programs fetched successfully",
  "data": [
    {
      "programId": "prog_1779175802952_zlymqs",
      "name": "Cyber Security",
      "description": "Cyber Security Program",
      "orgId": "org_1779085658651_hmhfv5",
      "mode": "test",
      "createdAt": "2025-05-19T13:30:02.952Z",
      "updatedAt": "2025-05-19T13:30:02.952Z"
    },
    {
      "programId": "prog_1779172339924_j3pr93",
      "name": "MongoDB",
      "description": "MongoDB Program",
      "orgId": "org_1779085658651_hmhfv5",
      "mode": "test",
      "createdAt": "2025-05-19T12:12:19.924Z",
      "updatedAt": "2025-05-19T12:12:19.924Z"
    }
  ]
}

​
Overview

Returns a list of all programmes created under your organisation. Use the programId from this response when issuing credentials.
No query parameters or request body required. Authentication via Authorization or X-Api-Key header.

​
Response Fields

FieldTypeDescription
programIdstringUnique programme identifier
namestringProgramme name
descriptionstringProgramme description
orgIdstringOrganisation the programme belongs to
modestring"live" or "test"
createdAtstringISO 8601 creation timestamp
updatedAtstringISO 8601 last-updated timestamp

​
Error Codes

CodeHTTPDescription
UNAUTHORIZED401Token missing, malformed, or revoked
FORBIDDEN403Token’s organisation not found or access denied
curl --request GET \
  --url https://api.getrecord.in/api/external/issuance/programs \
  --header 'Authorization: Bearer sk_test_your_token_here'

{
  "success": true,
  "message": "Programs fetched successfully",
  "data": [
    {
      "programId": "prog_1779175802952_zlymqs",
      "name": "Cyber Security",
      "description": "Cyber Security Program",
      "orgId": "org_1779085658651_hmhfv5",
      "mode": "test",
      "createdAt": "2025-05-19T13:30:02.952Z",
      "updatedAt": "2025-05-19T13:30:02.952Z"
    },
    {
      "programId": "prog_1779172339924_j3pr93",
      "name": "MongoDB",
      "description": "MongoDB Program",
      "orgId": "org_1779085658651_hmhfv5",
      "mode": "test",
      "createdAt": "2025-05-19T12:12:19.924Z",
      "updatedAt": "2025-05-19T12:12:19.924Z"
    }
  ]
}