Certificates

Read issued certificates and download them as PDFs.

Scopecertificates:read

Data requests act inside the key’s centre as the person who created the key: each needs the scope and that person’s current EduMark permission. See auth and pagination.

List certificates

GET/v1/certificates

Issued certificates, newest first. Filter by learner, course, run or status.

Scope certificates:read

Parameters

List certificates: parameters
Field	Details
`limit`	integerItems per page, 1 to 100.1 to 100Default `25`
`cursor`	string, optionalThe `next_cursor` from the previous page.Up to 512 characters
`learner_id`	string, optionalUp to 200 characters
`course_id`	string, optionalUp to 200 characters
`run_id`	string, optionalUp to 200 characters
`status`	enum, optionalOne of `valid`, `expiring`, `expired`, `revoked`
`updated_since`	string, optionalIssued or revoked since this time.

Headers

List certificates: headers
Field	Details
`EduMark-Version`	enumAPI version. Defaults to the latest.One of `2026-10-21`

Responses

Status	Meaning
200	Successful Response
400	Request rejected. Inspect error.code and request_id; failed work is not billed.
401	Request rejected. Inspect error.code and request_id; failed work is not billed.
403	Request rejected. Inspect error.code and request_id; failed work is not billed.
404	Request rejected. Inspect error.code and request_id; failed work is not billed.
409	Request rejected. Inspect error.code and request_id; failed work is not billed.
410	Request rejected. Inspect error.code and request_id; failed work is not billed.
413	Request rejected. Inspect error.code and request_id; failed work is not billed.
415	Request rejected. Inspect error.code and request_id; failed work is not billed.
422	Validation Error
429	Request rejected. Inspect error.code and request_id; failed work is not billed.
503	Request rejected. Inspect error.code and request_id; failed work is not billed.

Get a certificate

GET/v1/certificates/{certificate_id}

Scope certificates:read

Parameters

Get a certificate: parameters
Field	Details
`certificate_id`	stringRequired

Headers

Get a certificate: headers
Field	Details
`EduMark-Version`	enumAPI version. Defaults to the latest.One of `2026-10-21`

Responses

Status	Meaning
200	Successful Response
400	Request rejected. Inspect error.code and request_id; failed work is not billed.
401	Request rejected. Inspect error.code and request_id; failed work is not billed.
403	Request rejected. Inspect error.code and request_id; failed work is not billed.
404	Request rejected. Inspect error.code and request_id; failed work is not billed.
409	Request rejected. Inspect error.code and request_id; failed work is not billed.
410	Request rejected. Inspect error.code and request_id; failed work is not billed.
413	Request rejected. Inspect error.code and request_id; failed work is not billed.
415	Request rejected. Inspect error.code and request_id; failed work is not billed.
422	Validation Error
429	Request rejected. Inspect error.code and request_id; failed work is not billed.
503	Request rejected. Inspect error.code and request_id; failed work is not billed.

Request

curl 'https://api.edumark.ai/v1/certificates/certificate_123' \
  -H "Authorization: Bearer $EDUMARK_API_KEY"

Response 200JSON

{
  "academic_review_pending": false,
  "code": "AZCT-5UFX",
  "course_id": "course_1a2b3c4d5e6f",
  "course_title": "GCSE Biology: Cells and energy",
  "created_at": "2026-12-12T10:00:00Z",
  "download_url": "https://api.edumark.ai/v1/certificates/cert_0f1e2d3c4b5a69788796a5b4c3d2e1f0/pdf",
  "id": "cert_0f1e2d3c4b5a69788796a5b4c3d2e1f0",
  "issued_at": "2026-12-12T10:00:00Z",
  "learner_id": "user_4f1c0e9a2b7d4c3e8f6a1b2c3d4e5f60",
  "learner_name": "Amara Okafor",
  "run_id": "cdel_2f9c1a7b8e",
  "run_name": "Biology, autumn 2026",
  "source": "generated",
  "status": "valid",
  "verify_url": "https://app.edumark.ai/verify/AZCT-5UFX"
}

Download a certificate PDF

GET/v1/certificates/{certificate_id}/pdf

Scope certificates:read

Parameters

Download a certificate PDF: parameters
Field	Details
`certificate_id`	stringRequired

Headers

Download a certificate PDF: headers
Field	Details
`EduMark-Version`	enumAPI version. Defaults to the latest.One of `2026-10-21`

Responses

Status	Meaning
200	The certificate.
400	Request rejected. Inspect error.code and request_id; failed work is not billed.
401	Request rejected. Inspect error.code and request_id; failed work is not billed.
403	Request rejected. Inspect error.code and request_id; failed work is not billed.
404	Request rejected. Inspect error.code and request_id; failed work is not billed.
409	Request rejected. Inspect error.code and request_id; failed work is not billed.
410	Request rejected. Inspect error.code and request_id; failed work is not billed.
413	Request rejected. Inspect error.code and request_id; failed work is not billed.
415	Request rejected. Inspect error.code and request_id; failed work is not billed.
422	Validation Error
429	Request rejected. Inspect error.code and request_id; failed work is not billed.
503	Request rejected. Inspect error.code and request_id; failed work is not billed.