[{"data":1,"prerenderedAt":7},["ShallowReactive",2],{"docs-entities\u002Fcurrencies\u002Flocalizations\u002Fget":3,"docs-tabs-entities\u002Fcurrencies\u002Flocalizations\u002Fget":6},{"content":4,"lastmod":5},"## Get currency localizations\n\n`GET \u002Fv1\u002Fcurrencies\u002F:id\u002Flocalizations`\n\nReads the currency names and amount display settings per language. Call the method before changing localizations and after a failed write.\n\nScope: `crm`. A key in `READONLY` mode is accepted.\n\n## Parameters\n\n| Parameter | Type | Required | Default | Description |\n|----------|-----|:-----:|-----------|----------|\n| `id` (path) | string | yes | — | Currency code from the [currency list](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flist). Leading and trailing spaces are stripped, letters are uppercased |\n\n## Examples\n\n### curl — personal key\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fcurrencies\u002FQVC\u002Flocalizations\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth application\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fcurrencies\u002FQVC\u002Flocalizations\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — personal key\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fcurrencies\u002FQVC\u002Flocalizations', {\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n  },\n})\nconst { success, data } = await res.json()\n```\n\n### JavaScript — OAuth application\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fcurrencies\u002FQVC\u002Flocalizations', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\nconst { success, data } = await res.json()\n```\n\n## Response fields\n\n| Field | Type | Description |\n|------|-----|----------|\n| `success` | boolean | Always `true` on success |\n| `data` | object | Map of localizations keyed by language code. If there are no localizations, an empty object `{}` |\n| `data.{lang}` | object | Settings for the `{lang}` language, for example `en` or `ru` |\n| `data.{lang}.fullName` | string | Full currency name |\n| `data.{lang}.formatString` | string | Amount display template, `#` is the placeholder for the number |\n| `data.{lang}.decPoint` | string | Decimal separator |\n| `data.{lang}.thousandsVariant` | string | Thousands separator variant |\n| `data.{lang}.thousandsSep` | string \\| null | Thousands separator character or HTML entity |\n| `data.{lang}.decimals` | number | Number of digits after the decimal separator |\n| `data.{lang}.hideZero` | boolean | Hide trailing zeros in the fractional part |\n\n## Response example\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"en\": {\n      \"fullName\": \"Example currency\",\n      \"formatString\": \"# QVC\",\n      \"decPoint\": \".\",\n      \"thousandsVariant\": \"S\",\n      \"thousandsSep\": \" \",\n      \"decimals\": 2,\n      \"hideZero\": false\n    },\n    \"ru\": {\n      \"fullName\": \"Example currency\",\n      \"formatString\": \"# QVC\",\n      \"decPoint\": \".\",\n      \"thousandsVariant\": \"S\",\n      \"thousandsSep\": \" \",\n      \"decimals\": 2,\n      \"hideZero\": false\n    }\n  }\n}\n```\n\n## Error response example\n\n404 — a currency with the specified code is not found:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"ENTITY_NOT_FOUND\",\n    \"message\": \"Not found\"\n  }\n}\n```\n\n## Errors\n\n| HTTP | Code | Description |\n|------|-----|----------|\n| 400 | `INVALID_ID` | The currency code is empty after the spaces are stripped |\n| 404 | `ENTITY_NOT_FOUND` | A currency with the specified code is not found |\n| 422 | `BITRIX_ERROR` | Bitrix24 rejected reading the currency or its localizations |\n| 403 | `BITRIX_ACCESS_DENIED` | The user has no rights for the operation in Bitrix24 |\n| 403 | `SCOPE_DENIED` | The API key does not have the `crm` scope |\n| 401 | `MISSING_API_KEY` | The `X-Api-Key` header is missing |\n| 401 | `TOKEN_MISSING` | The API key has no configured Bitrix24 tokens |\n| 502 | `BITRIX_RESPONSE_INVALID` | A response of an unexpected structure was received |\n| 502 | `BITRIX_UNAVAILABLE` | Bitrix24 is unavailable |\n\nFull list of common API errors — [Errors](\u002Fdocs\u002Ferrors).\n\n## Known specifics\n\nHTML entities in the format and separator strings are preserved as is, for example `&nbsp;`.\n\n## See also\n\n- [Set currency localizations](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Fset)\n- [Delete currency localizations](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Fdelete)\n- [Currency localization fields](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Ffields)\n- [Get currency](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Fget)\n","2026-10-13",{},1794739364988]