Help center
https://api.certo.bio/v1openapi.json
Applications
GET
/v1/applicationsscope hiring:readApplications 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
| Name | Type | Description |
|---|---|---|
| position_id | uuid | Only applications to this position. |
| status | one of open, withdrawn | Only open or only withdrawn applications. |
| 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 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
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