[{"data":1,"prerenderedAt":11},["ShallowReactive",2],{"docs-entities\u002Fcurrencies\u002Flocalizations":3,"docs-tabs-entities\u002Fcurrencies\u002Flocalizations":6},{"content":4,"lastmod":5},"# Currency localizations\n\nCurrency display settings in different languages: amount format, name, separators. The currency code is passed in the path, for example `USD`. The same settings are also returned in the `lang` field when you [get a currency](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Fget). HTML entities in amount formats are preserved.\n\nScope: `crm`\n\n## Operations\n\n- [Get currency localizations](.\u002Flocalizations\u002Fget.md) — `GET \u002Fv1\u002Fcurrencies\u002F:id\u002Flocalizations`\n- [Set currency localizations](.\u002Flocalizations\u002Fset.md) — `PUT \u002Fv1\u002Fcurrencies\u002F:id\u002Flocalizations`\n- [Delete currency localizations](.\u002Flocalizations\u002Fdelete.md) — `DELETE \u002Fv1\u002Fcurrencies\u002F:id\u002Flocalizations?langs=en,de`\n- [Currency localization fields](.\u002Flocalizations\u002Ffields.md) — `GET \u002Fv1\u002Fcurrencies\u002F:id\u002Flocalizations\u002Ffields`\n\n## See also\n\n- [Currencies](\u002Fdocs\u002Fentities\u002Fcurrencies)\n- [Get currency](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Fget)\n","2026-10-15",{"localizations\u002Fget.md":7,"localizations\u002Fset.md":8,"localizations\u002Fdelete.md":9,"localizations\u002Ffields.md":10},"## 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","## Set currency localizations\n\n`PUT \u002Fv1\u002Fcurrencies\u002F:id\u002Flocalizations`\n\nCreates or changes the currency display settings for the specified languages. Only the languages and fields you pass are updated.\n\nScope: `crm`.\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, and letters are uppercased |\n\n## Request fields (body)\n\n| Field | Type | Required | Description |\n|------|-----|:-----:|----------|\n| `localizations` | object | yes | A non-empty map of languages. Other top-level fields are not accepted |\n| `localizations.{lang}` | object | yes | A non-empty settings object for the `{lang}` language, for example `en` or `ru`. Pass at least one of the fields below in each object |\n| `localizations.{lang}.fullName` | string | no | Full currency name |\n| `localizations.{lang}.formatString` | string | no | Amount display template, `#` is the placeholder for the number |\n| `localizations.{lang}.decPoint` | string | no | Decimal separator |\n| `localizations.{lang}.thousandsVariant` | string | no | Thousands separator variant |\n| `localizations.{lang}.thousandsSep` | string \\| null | no | Thousands separator character. The stored value depends on `thousandsVariant` |\n| `localizations.{lang}.decimals` | number | no | Number of digits after the decimal separator |\n| `localizations.{lang}.hideZero` | boolean | no | Hide trailing zeros in the fractional part |\n\n## Examples\n\n### curl — personal key\n\n```bash\ncurl -X PUT \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fcurrencies\u002FQVC\u002Flocalizations\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"localizations\":{\"en\":{\"fullName\":\"Example currency\",\"formatString\":\"# QVC\",\"decimals\":2,\"hideZero\":false},\"ru\":{\"fullName\":\"Example currency\",\"formatString\":\"# QVC\",\"decimals\":2,\"hideZero\":false}}}'\n```\n\n### curl — OAuth application\n\n```bash\ncurl -X PUT \"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  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"localizations\":{\"en\":{\"fullName\":\"Example currency\",\"formatString\":\"# QVC\",\"decimals\":2,\"hideZero\":false},\"ru\":{\"fullName\":\"Example currency\",\"formatString\":\"# QVC\",\"decimals\":2,\"hideZero\":false}}}'\n```\n\n### JavaScript — personal key\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fcurrencies\u002FQVC\u002Flocalizations', {\n  method: 'PUT',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\"localizations\":{\"en\":{\"fullName\":\"Example currency\",\"formatString\":\"# QVC\",\"decimals\":2,\"hideZero\":false},\"ru\":{\"fullName\":\"Example currency\",\"formatString\":\"# QVC\",\"decimals\":2,\"hideZero\":false}}}),\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  method: 'PUT',\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\"localizations\":{\"en\":{\"fullName\":\"Example currency\",\"formatString\":\"# QVC\",\"decimals\":2,\"hideZero\":false},\"ru\":{\"fullName\":\"Example currency\",\"formatString\":\"# QVC\",\"decimals\":2,\"hideZero\":false}}}),\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` | boolean | Always `true`. The result is confirmed by a second read of the localizations |\n\n## Response example\n\nHTTP `200 OK`:\n\n```json\n{\n  \"success\": true,\n  \"data\": true\n}\n```\n\n## Error response example\n\n422 — the saved values did not match the ones passed. For example, `thousandsVariant` equals `B` while a space was passed in `thousandsSep`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ERROR\",\n    \"message\": \"Bitrix24 did not apply the requested currency localizations\"\n  }\n}\n```\n\n## Errors\n\n| HTTP | Code | Description |\n|------|-----|----------|\n| 400 | `MISSING_REQUIRED_FIELDS` | `localizations` is missing or empty, other top-level fields were passed, a language code is empty, or its settings object is empty |\n| 400 | `UNKNOWN_FIELD` | An unknown localization field was passed |\n| 400 | `INVALID_FIELD_VALUE` | An object or an array was passed instead of a scalar value |\n| 400 | `INVALID_ID` | The currency code is empty after spaces are stripped |\n| 404 | `ENTITY_NOT_FOUND` | No currency with the specified code was found |\n| 422 | `BITRIX_ERROR` | Bitrix24 rejected the write, reported a failure, or the second read did not confirm the passed values |\n| 403 | `WRITE_BLOCKED_READONLY_KEY` | The key is in `READONLY` mode |\n| 403 | `BITRIX_ACCESS_DENIED` | The user has no permission 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 with 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\nThe write is not transactional: an error does not roll back the values already saved. Before retrying, call [Get currency localizations](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Fget) and compare the current settings with the settings you need.\n\n## See also\n\n- [Get currency localizations](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Fget)\n- [Currency localization fields](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Ffields)\n- [Delete currency localizations](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Fdelete)\n","## Delete currency localizations\n\n`DELETE \u002Fv1\u002Fcurrencies\u002F:id\u002Flocalizations`\n\nDeletes the currency display settings for the specified languages. If needed, create them again with the localizations write method.\n\nScope: `crm`.\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| `langs` (query) | string | yes | — | Language codes from the [currency localizations](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Fget), comma-separated. Pass the parameter exactly once, for example `langs=en,ru` |\n\nNo request body is passed. Other query parameters are not accepted.\n\n## Examples\n\n### curl — personal key\n\n```bash\ncurl -X DELETE \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fcurrencies\u002FQVC\u002Flocalizations?langs=en,ru\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth application\n\n```bash\ncurl -X DELETE \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fcurrencies\u002FQVC\u002Flocalizations?langs=en,ru\" \\\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?langs=en,ru', {\n  method: 'DELETE',\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?langs=en,ru', {\n  method: 'DELETE',\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` | boolean | Always `true`. The result is confirmed by a second read of the localizations |\n\n## Response example\n\nHTTP `200 OK`:\n\n```json\n{\n  \"success\": true,\n  \"data\": true\n}\n```\n\n## Error response example\n\n422 — all the specified languages are already absent:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ERROR\",\n    \"message\": \"Bitrix24 did not apply the requested currency localizations\"\n  }\n}\n```\n\n## Errors\n\n| HTTP | Code | Description |\n|------|-----|----------|\n| 400 | `MISSING_REQUIRED_FIELDS` | `langs` is missing, empty, repeated, or contains an empty language code. It is also returned if any other query parameter or a request body is passed |\n| 400 | `INVALID_ID` | The currency code is empty after spaces are stripped |\n| 404 | `ENTITY_NOT_FOUND` | A currency with the specified code is not found |\n| 422 | `BITRIX_ERROR` | All the specified languages are already absent, Bitrix24 rejected the deletion, reported a failure, or the second read still found some of the languages |\n| 403 | `WRITE_BLOCKED_READONLY_KEY` | The key works in `READONLY` mode |\n| 403 | `BITRIX_ACCESS_DENIED` | The user has no rights to perform 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\nThe deletion is not transactional: on an error some of the languages may already be deleted. Before retrying, call [Get currency localizations](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Fget) and pass only the remaining languages.\n\n## See also\n\n- [Get currency localizations](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Fget)\n- [Set currency localizations](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Fset)\n- [Currency localization fields](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Ffields)\n","## Currency localization fields\n\n`GET \u002Fv1\u002Fcurrencies\u002F:id\u002Flocalizations\u002Ffields`\n\nDescribes the currency name and amount format settings for each language. Use this reference before writing localizations.\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). The metadata is shared by all currencies; the code's existence is not checked |\n\n## Examples\n\n### curl — personal key\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fcurrencies\u002FQVC\u002Flocalizations\u002Ffields\" \\\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\u002Ffields\" \\\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\u002Ffields', {\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\u002Ffields', {\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 localization field metadata |\n| `data.fullName` | object | Full currency name. Setting metadata |\n| `data.fullName.bitrixName` | string | Source field name: `FULL_NAME` |\n| `data.fullName.type` | string | Value type: `string` |\n| `data.fullName.readonly` | boolean | `false` — the setting can be passed on write |\n| `data.formatString` | object | Amount display template, `#` is the placeholder for the number. Setting metadata |\n| `data.formatString.bitrixName` | string | Source field name: `FORMAT_STRING` |\n| `data.formatString.type` | string | Value type: `string` |\n| `data.formatString.readonly` | boolean | `false` — the setting can be passed on write |\n| `data.decPoint` | object | Decimal separator. Setting metadata |\n| `data.decPoint.bitrixName` | string | Source field name: `DEC_POINT` |\n| `data.decPoint.type` | string | Value type: `string` |\n| `data.decPoint.readonly` | boolean | `false` — the setting can be passed on write |\n| `data.thousandsVariant` | object | Thousands separator variant. Setting metadata |\n| `data.thousandsVariant.bitrixName` | string | Source field name: `THOUSANDS_VARIANT` |\n| `data.thousandsVariant.type` | string | Value type: `string` |\n| `data.thousandsVariant.readonly` | boolean | `false` — the setting can be passed on write |\n| `data.thousandsSep` | object | Thousands separator character. Setting metadata |\n| `data.thousandsSep.bitrixName` | string | Source field name: `THOUSANDS_SEP` |\n| `data.thousandsSep.type` | string | Value type: `string` |\n| `data.thousandsSep.readonly` | boolean | `false` — the setting can be passed on write |\n| `data.decimals` | object | Number of digits after the decimal separator. Setting metadata |\n| `data.decimals.bitrixName` | string | Source field name: `DECIMALS` |\n| `data.decimals.type` | string | Value type: `number` |\n| `data.decimals.readonly` | boolean | `false` — the setting can be passed on write |\n| `data.hideZero` | object | Hide trailing zeros in the fractional part. Setting metadata |\n| `data.hideZero.bitrixName` | string | Source field name: `HIDE_ZERO` |\n| `data.hideZero.type` | string | Value type: `boolean` |\n| `data.hideZero.readonly` | boolean | `false` — the setting can be passed on write |\n\n## Response example\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"fullName\": {\n      \"bitrixName\": \"FULL_NAME\",\n      \"type\": \"string\",\n      \"readonly\": false\n    },\n    \"formatString\": {\n      \"bitrixName\": \"FORMAT_STRING\",\n      \"type\": \"string\",\n      \"readonly\": false\n    },\n    \"decPoint\": {\n      \"bitrixName\": \"DEC_POINT\",\n      \"type\": \"string\",\n      \"readonly\": false\n    },\n    \"thousandsVariant\": {\n      \"bitrixName\": \"THOUSANDS_VARIANT\",\n      \"type\": \"string\",\n      \"readonly\": false\n    },\n    \"thousandsSep\": {\n      \"bitrixName\": \"THOUSANDS_SEP\",\n      \"type\": \"string\",\n      \"readonly\": false\n    },\n    \"decimals\": {\n      \"bitrixName\": \"DECIMALS\",\n      \"type\": \"number\",\n      \"readonly\": false\n    },\n    \"hideZero\": {\n      \"bitrixName\": \"HIDE_ZERO\",\n      \"type\": \"boolean\",\n      \"readonly\": false\n    }\n  }\n}\n```\n\n## Error response example\n\n403 — the key has no `crm` scope:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SCOPE_DENIED\",\n    \"message\": \"This endpoint requires 'crm' scope\",\n    \"hint\": \"This request needs the 'crm' scope, which the calling key does not carry. Add 'crm' to this key in the developer cabinet (or through the management API), then repeat the call.\",\n    \"cause\": \"key_scope_missing\",\n    \"requiredScope\": \"crm\",\n    \"keyScopes\": [\n      \"task\",\n      \"im\"\n    ],\n    \"fix\": {\n      \"action\": \"edit_key_scopes\",\n      \"via\": \"cabinet\"\n    },\n    \"userMessage\": \"The app's API key lacks the “CRM” permission. You can add it in the key settings in the developer cabinet.\"\n  }\n}\n```\n\n## Errors\n\n| HTTP | Code | Description |\n|------|-----|----------|\n| 422 | `BITRIX_ERROR` | Bitrix24 rejected the reference request |\n| 403 | `BITRIX_ACCESS_DENIED` | The user has no permission for the operation in Bitrix24 |\n| 403 | `SCOPE_DENIED` | The API key has no `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 with an unexpected structure was received |\n| 502 | `BITRIX_UNAVAILABLE` | Bitrix24 is unavailable |\n\nFull list of common API errors — [Errors](\u002Fdocs\u002Ferrors).\n\n## See also\n\n- [Set currency localizations](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Fset)\n- [Get currency localizations](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Fget)\n- [Delete currency localizations](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Fdelete)\n",1794739364561]