Help center
https://api.certo.bio/v1openapi.json
Asks to read
GET
/v1/access-requestsscope hiring:readThe organisation's asks to read a published passport, newest first.
As an MCP tool: list_access_requests
Query parameters
| Name | Type | Description |
|---|---|---|
| status | one of open, approved, declined, expired, withdrawn | Only asks in this state. |
| cursor | string | The next_cursor of the previous page. |
| limit | integer, 1 to 100 | How many on a page. 25 by default. |
Response fields
- data
- array of object. This page, newest first.
- data[].id
- uuid. The ask's id.
- data[].passport_url
- string. The passport's address.
- data[].name
- string or null. The passport's display name.
- data[].status
- one of open, approved, declined, expired, withdrawn. Where it stands. An unanswered ask past its date reads expired.
- data[].position_id
- uuid or null. The position it was made for; null for none.
- data[].candidate_id
- uuid or null. The grant once approved: the id for /candidates/{id}.
- data[].custom_data
- object or null. Your own data on the ask, as you sent it; null for none.
- data[].created_at
- string. When it was asked (ISO 8601).
- data[].expires_at
- string or null. When an unanswered ask expires (ISO 8601).
- next_cursor
- string or null. Pass it as
cursorfor 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