https://api.certo.bio/v1openapi.json

Positions

GET/v1/positionsscope hiring:read

The organisation's positions with how many were invited, accepted and are ready.

As an MCP tool: list_positions

Query parameters

NameTypeDescription
statusone of open, closedOnly open or only closed positions.
cursorstringThe next_cursor of the previous page.
limitinteger, 1 to 100How 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 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