List contract types

get

https://api.join.com/v3/contract-types

Returns contract types and the limits they impose on a job’s employment terms. Use a returned ID as contractTypeId when creating or updating a job.

Filter by countryCode for on-site or hybrid jobs. Omit it for the generic types used by remote jobs. Results are ordered by creation date, oldest first, and returned together in one response.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

countryCode

string

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

Restrict to the types of one country, by ISO 3166-1 alpha-2 code. Omit it for the generic types a remote job uses

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

200List contract types

400The request could not be processed: an unsupported API version, or a filter value the API could not resolve (filter_invalid, naming the field). A filter that is structurally wrong — an unknown enum value — is rejected earlier, by schema validation, with 422 validation_error.

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.