List jobs

get

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

Returns your company’s published jobs. Drafts are excluded.

Results are paginated and ordered by creation date, oldest first unless sort requests newest first.
Filters combine with AND. No matches returns an empty list.
Follow nextCursor until it is null.

See Pagination, filtering and sorting for shared conventions.

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:

status

array of strings

Filter by status — a job matches when it has any of the given statuses. Repeat the parameter to give several (?status=ONLINE&status=OFFLINE); omitted returns all

status

workplaceType

string

enum

Filter by workplace model

Allowed:

remoteType

string

enum

Filter by remote scope

Allowed:

locationId

integer

Jobs at a specific location. Remote jobs never match it, so with workplaceType=REMOTE or any remoteType the list is empty

contractTypeId

integer

Jobs of a specific contract type

remoteRegionId

integer

Jobs scoped to a specific remote region

employmentType

string

Jobs of a specific employment type, by slug

countryCode

string

^[A-Za-z]{2}$

Filter by ISO 3166-1 alpha-2 country code

priority

string

enum

Filter by priority

Allowed:

languageCode

string

enum

Filter by the language the ad is written in. Accept-Language selects the language of supported display names in the response.

Allowed:

externalId

string

length ≤ 250

Jobs carrying your reference. Returns all matches, since it is not unique

createdAfter

date-time

Jobs created at or after this time

createdBefore

date-time

Jobs created strictly before this time

updatedAfter

date-time

Jobs updated at or after this time

updatedBefore

date-time

Jobs updated strictly before this time

string

Free-text search across title and description

Headers

Accept-Language

string

Preferred language for translated display names. Supported languages are en, de, fr, es, it and nl. Regional variants use their main language (de-CH → de); a list uses the first supported language. If the header is omitted or no language matches, the response uses English. Content-Language identifies the language used. Identifiers, slugs and enum values stay stable. Use languageCode to filter jobs by the language of the ad.

Join-Version

string

Selects a dated API revision in YYYY-MM-DD format, such as 2026-11-01. Pin this header to choose the revision explicitly; omitting it uses the server’s default. An unsupported value returns 400 unsupported_api_version. See Versions and compatibility.

Responses

200The company’s jobs

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. For a write, the outcome may be uncertain: read the affected record before retrying. See Responses, errors and retries.