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
language parameter| Value | Language |
|---|---|
en | English (default) |
de | German |
fr | French |
es | Spanish |
it | Italian |
nl | Dutch |
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
| Translated | Never translated |
|---|---|
Display names of lookup values (name) | Identifiers (id) |
| Display names embedded in a job | Slugs |
| Enum values | |
| Error codes | |
| Text your company entered, such as job titles, office names and stage names |
language and languageCode
language and languageCodeOn the jobs list, two parameters look alike and do different things:
| Parameter | Effect |
|---|---|
language | Translates the display names in the response. |
languageCode | Filters jobs by the language the job ad is written in. |