Issued records

Query parameters

Response fields

data

array of object. This page, newest first.

data[].id

uuid. The issued record's id.

data[].kind

one of employment, education, certification. What was issued: a leaver record, a degree or a certificate.

data[].name

string. The person's name as issued.

data[].email

string. The address the claim link went to.

data[].status

one of unclaimed, claimed, expired, merge_review, withdrawn. Whether the person claimed it. merge_review: they already hold a passport and certo is adding it there.

data[].certificate

object or null. The newest certificate over the organisation's own confirmation; null before one is signed.

data[].certificate.id

uuid. The certificate's id.

data[].certificate.url

string. Its public page, /v/<id>.

data[].certificate.state

one of signed, revoked. signed, or revoked by the holder or by you.

data[].certificate.revoked_at

string or null. When it was revoked (ISO 8601); null while signed.

data[].identity_match

one of matches, checking, differs or null. For a provider's row with a date of birth: whether it matches the learner's identity check; null otherwise.

data[].custom_data

object or null. Your own data on the issued record, as you sent it; null for none.

data[].created_at

string. When it was issued (ISO 8601).

next_cursor

string or null. Pass it as cursor for the next page; null on the last.

Errors

• 400 api.credential_in_url
• 401 api.key_invalid
• 401 api.key_expired
• 401 api.key_revoked
• 401 api.key_suspended
• 403 api.scope_missing
• 429 api.rate_limited