List applications

get

https://api.join.com/v3/applications

Returns your company’s applications as a paginated list, sorted by creation date, oldest first unless sort asks for newest first. Filters combine with AND, and a filter matching nothing returns an empty list rather than a not-found. Applications deleted in the JOIN product stop appearing here. Use limit and cursor to page through results; the response’s nextCursor is null on the last page.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

limit

integer

1 to 50

Defaults to 10

Number of records to return

cursor

string

Position from the previous response's nextCursor. Omit on the first request

sort

string

enum

Order by creation date: createdAt for oldest first, the default, or -createdAt for newest first. A cursor keeps the order it was read under

Allowed:

jobId

integer

Filter by the job applied to

candidateId

integer

Filter by the candidate, using their id within your company

status

string

enum

Filter by hiring status

Allowed:

pipelineStageType

string

enum

Filter by the type of the stage the application sits in. An application with no stage matches no value

externalId

string

length ≤ 50

Filter by your own reference

createdAfter

date-time

Only applications created on or after this ISO 8601 timestamp

createdBefore

date-time

Only applications created before this ISO 8601 timestamp

updatedAfter

date-time

Only applications last changed on or after this ISO 8601 timestamp

updatedBefore

date-time

Only applications last changed before this ISO 8601 timestamp

Headers

Join-Version

string

Selects the dated API version the request runs against, named after its release day as YYYY-MM-DD, e.g. 2026-11-01. Omit to use the current default version (2026-11-01). A value that is not a supported version is rejected with 400 unsupported_api_version.

Responses

200The company’s applications

401Authentication failed. Either the Authorization: Bearer header is missing (authentication_required), or the presented token is malformed, unknown, revoked, or belongs to a company that no longer has API access (token_invalid).

422A path parameter, query parameter or body field failed schema validation.

429The token exceeded its sustained (600/60s) or burst (100/10s) request quota. Retry after the number of seconds in Retry-After.

500An unexpected error occurred on JOIN’s side. The request may be retried.