Help center
https://api.certo.bio/v1openapi.json
An ask to read
GET
/v1/access-requests/{id}scope hiring:readOne ask to read.
As an MCP tool: get_access_request
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | uuid | Yes | The ask's id. |
Response fields
- access_request
- object. The ask.
- access_request.id
- uuid. The ask's id.
- access_request.passport_url
- string. The passport's address.
- access_request.name
- string or null. The passport's display name.
- access_request.status
- one of open, approved, declined, expired, withdrawn. Where it stands. An unanswered ask past its date reads expired.
- access_request.position_id
- uuid or null. The position it was made for; null for none.
- access_request.candidate_id
- uuid or null. The grant once approved: the id for /candidates/{id}.
- access_request.custom_data
- object or null. Your own data on the ask, as you sent it; null for none.
- access_request.created_at
- string. When it was asked (ISO 8601).
- access_request.expires_at
- string or null. When an unanswered ask expires (ISO 8601).
Errors
- 404 access_request.not_found
- 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