List remote regions

get

https://api.join.com/v3/remote-regions

Returns the regions a remote job may be scoped to. This resolves the remoteRegion a job reads back, supplies the remoteRegionId job filter, and supplies the remoteRegionId a job is created or updated with. The read is unpaginated — every record is returned — and the list is sorted by creation date, oldest first.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

language

string

enum

Defaults to en

Translates the display names in the response to this ISO 639-1 language. JOIN supports nl, en, fr, de, it and es and no others, so any other value is rejected with 400 unsupported_language rather than answered in English. Identifiers, slugs, enum values and error codes are never translated. Not to be confused with the languageCode job filter, which selects the language an ad is written in.

Allowed:

countryCode

string

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

Restrict to the regions covering one country, by ISO 3166-1 alpha-2 code

string

Free-text search over the region name

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

200List remote regions

400The request could not be processed: an unsupported API version, or a filter value the surface 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. The request may be retried.