certo.bio
Register
Help center
https://api.certo.bio/v1openapi.json

A position

GET/v1/positions/{id}scope hiring:read

One position: its terms (what candidates are asked to share and have ready) and its counts.

As an MCP tool: get_position

Path parameters

NameTypeRequiredDescription
iduuidYesThe position's id.

Response fields

position
object. The position.
position.id
uuid. The position's id.
position.title
string. The position's title, as the console shows it.
position.location
string or null. Where the job is, as typed; null when not given.
position.status
one of open, closed. open: inviting under it; closed: kept, no new invitations.
position.counts
object. How far the position is.
position.counts.invited
integer. Invitations and asks to read under the position.
position.counts.accepted
integer. Of those, accepted or approved.
position.counts.ready
integer. Candidates under it whose checklist is complete.
position.custom_data
object or null. Your own data on the position, as you sent it; null for none.
position.created_at
string. When it was made (ISO 8601).
scope_types
array of string. The record types candidates are asked to share.
include_contact
boolean. Candidates are asked for their contact details too.
requirements
object or null. What candidates must have ready; null for the defaults.

Errors

  • 404 position.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