Locale and market

A V2 response separates three concerns:

Market — controls which inventory and pricing the agency sees.
Currency — the currency of the prices in the response.
Locale — the language of the human-readable text fields.

Market and currency are explicit on inventory and search requests. Locale is not chosen at request time — instead, localized fields carry every available translation and the partner picks the one that fits their audience. The valid (market, currency) combinations are listed on Market Currency Profiles.

Localized fields

A localized field is an array of {locale, value} entries:

"name": [
  { "locale": "en", "value": "..." },
  { "locale": "nb-NO", "value": "..." }
]

locale is an IETF BCP 47 code (en, en-GB, da-DK, nb-NO, etc.); value is the language-specific text.

Each localized array carries an entry per translation available for that field — translations are not filtered by the response's market or currency. Choose the entry whose locale best matches your audience and fall back to en if none of the more specific tags match.

Table of Contents

Locale and market

Localized fields