Skip to content

Get Certificate

GET
/certificates/{certificateId}

Retrieves a single Certificate by ID, including resource/action names and attachments. Scoped to the current Space — returns 404 if the Certificate does not exist or belongs to a different Space.

certificateId
required
string
X-Space-Id
required
string format: uuid

UUID of the target Space (tenant boundary). Validated against user access.

object
id
required

Certificate ID

string format: uuid
Example
550e8400-e29b-41d4-a716-446655440000
spaceId
required

Space ID

string format: uuid
Example
660e8400-e29b-41d4-a716-446655440000
resourceId
required

Resource ID

string format: uuid
Example
770e8400-e29b-41d4-a716-446655440000
resourceName
required

Resource name

string
Example
John Smith
actionId
required

Action ID

string format: uuid
Example
880e8400-e29b-41d4-a716-446655440000
actionName
required

Action name

string
Example
Fire safety training
name
required

Certificate name

string
Example
Fire safety certificate 2026
issuedAt
required

Issue date (ISO 8601)

string
Example
2026-01-15
expiresAt
required

Expiration date (ISO 8601)

string
Example
2031-01-15
attachments
required

Attached files

Array<object>
object
id
required

Attachment ID

string format: uuid
Example
880e8400-e29b-41d4-a716-446655440000
url
required

File URL

string
Example
https://storage.example.com/docs/certificate.pdf
label
required

Human-readable label

string
Example
Certificate PDF
createdAt
required

Upload timestamp (ISO 8601)

string
Example
2026-01-15T10:30:00.000Z

Unauthorized — missing or invalid JWT

Forbidden — insufficient permissions

Resource not found