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

Applications

GET/v1/applicationsscope hiring:read

Applications made to the organisation with Apply with certo, newest first: the job in the site's words, the terms each was made on, where it came from and whether it is still open. No passport content: read one with /applications/{id}.

As an MCP tool: list_applications

Query parameters

NameTypeDescription
position_iduuidOnly applications to this position.
statusone of open, withdrawnOnly open or only withdrawn applications.
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 application's id: the id for /applications/{id}, the token's sub and the webhook's subject.
data[].position_id
uuid or null. The position it was made to; null for one of your own jobs or an open application.
data[].candidate_id
uuid. The grant the application made: the id for /candidates/{id}.
data[].job
object. The job in the site's words, never verified; each null where the site gave none (none at all: an open application).
data[].job.ref
string or null. The site's own reference for the job, at most 200 characters.
data[].job.title
string or null. The job's title as the site names it (a position's own title wins).
data[].job.hiring_company
string or null. The hiring company as the site names it (a job board's listing): words only, never a certo organisation, never a reader.
data[].job.url
string or null. The job's page.
data[].state
string or null. Your site's state: the nonce the button or the apply session carried; null without one.
data[].terms
object. The terms the candidate applied on: what you may read. A snapshot, kept as it was at Apply whatever changes later.
data[].terms.source
one of general, position, session. Where the terms came from: general (your general application), position (the position's), session (an apply session your server made).
data[].terms.scope_types
array of string or null. The record types the candidate shares; null for every one.
data[].terms.include_contact
boolean. The candidate's contact details are shared.
data[].terms.include_birth_date
boolean. The date of birth is shared.
data[].terms.birth_date_reason
string or null. Why the date of birth is asked, as the candidate read it; null without it.
data[].terms.requirements
object or null. What the candidate should have ready (docs/request-requirements.md); null for the defaults.
data[].session_id
string or null. The apply session it spent (as_...); null unless its terms came from one.
data[].custom_data
object or null. Your own data on the application (from the apply session that made it), as you sent it; null for none.
data[].origin_host
string or null. The site it came from: the host of the page that opened Apply with certo; null for a test origin (localhost).
data[].submitted_at
string. When the candidate last pressed Apply (ISO 8601).
data[].withdrawn_at
string or null. When the candidate withdrew it (ISO 8601); null while open.
data[].status
one of open, withdrawn. open, or withdrawn: the candidate withdrew it (or its grant ended) and nothing more may be read.
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