Help center
https://api.certo.bio/v1openapi.json
Positions
GET
/v1/positionsscope hiring:readThe organisation's positions with how many were invited, accepted and are ready.
As an MCP tool: list_positions
Query parameters
| Name | Type | Description |
|---|---|---|
| status | one of open, closed | Only open or only closed positions. |
| 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 position's id.
- data[].title
- string. The position's title, as the console shows it.
- data[].location
- string or null. Where the job is, as typed; null when not given.
- data[].status
- one of open, closed. open: inviting under it; closed: kept, no new invitations.
- data[].counts
- object. How far the position is.
- data[].counts.invited
- integer. Invitations and asks to read under the position.
- data[].counts.accepted
- integer. Of those, accepted or approved.
- data[].counts.ready
- integer. Candidates under it whose checklist is complete.
- data[].custom_data
- object or null. Your own data on the position, as you sent it; null for none.
- data[].created_at
- string. When it was made (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