Overview
Several Open API responses contain human-readable text, such as validation and error messages. You can control the language of this content by specifying a language code with your request.
Specifying the language
Provide the language parameter as a two-letter ISO 639-1 code:
- As a query string parameter on any request — for example,
?language=fr. - As a field in the request body for
POST,PUT, andDELETErequests.
Supported languages
| Code | Language |
|---|---|
en | English |
fr | French |
it | Italian |
ko | Korean |
es | Spanish |
de | German |
The default language is English (en). If you request a code that is not supported, the response falls back to English.
How the language is determined
When a request is received, the response language is resolved in the following order:
- The
Accept-Languagerequest header, if it matches a supported language. - The
languageparameter — when provided, it overrides theAccept-Languageheader. - Your site’s default language.
- English (
en) as the final fallback.
If the resolved language is not in the supported list, the response falls back to English (en).
Response header
Every response includes a Content-Language header indicating the language that was used.
