Help center
https://api.certo.bio/v1openapi.json
A candidate's age
GET
/v1/candidates/{id}/agescope candidates:readLoggedWhether the candidate is over 18 and over 21, which every grant answers; the date of birth itself only where the candidate shared it. Every call is logged and the candidate sees it.
Every call is a read of the candidate's passport: it is logged, and the candidate sees that your organisation read it.
As an MCP tool: get_candidate_age
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | uuid | Yes | The candidate (the grant). |
Response fields
- known
- boolean. Whether certo holds the candidate's date of birth (from their identity check). False: the rest is null.
- over_18
- boolean or null. Over 18 today.
- over_21
- boolean or null. Over 21 today.
- date_of_birth
- string or null. YYYY-MM-DD, only where the candidate shared it.
Errors
- 404 candidate.not_found
- 409 grant.not_live
- 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