Localization

Translate display names in responses with the language parameter.

Display names in responses, such as the name of an employment type, a contract type or a benefit, can be returned in one of six languages.

The language parameter

ValueLanguage
enEnglish (default)
deGerman
frFrench
esSpanish
itItalian
nlDutch
curl "https://api.join.com/v3/contract-types?country=DE&language=de" \
  -H "Authorization: Bearer $JOIN_API_TOKEN"

Any other value returns 400 unsupported_language. The API does not fall back to English for an unsupported value.

What is translated

TranslatedNever translated
Display names of lookup values (name)Identifiers (id)
Display names embedded in a jobSlugs
Enum values
Error codes
Text your company entered, such as job titles, office names and stage names

language and languageCode

On the jobs list, two parameters look alike and do different things:

ParameterEffect
languageTranslates the display names in the response.
languageCodeFilters jobs by the language the job ad is written in.