[{"data":1,"prerenderedAt":7},["ShallowReactive",2],{"docs-entities\u002Fcurrencies\u002Fbase":3,"docs-tabs-entities\u002Fcurrencies\u002Fbase":6},{"content":4,"lastmod":5},"## Base currency\n\n`GET \u002Fv1\u002Fcurrencies\u002Fbase`\n\nReturns the base currency of the Bitrix24 account — exchange rates of all other currencies in CRM are set against it.\n\nScope: `crm`. A key in `READONLY` mode is accepted.\n\n## Examples\n\n### curl — personal key\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fcurrencies\u002Fbase\" \\\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\u002Fbase\" \\\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\u002Fbase', {\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\u002Fbase', {\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 | Object with the base currency code |\n| `data.currency` | string | Base currency code. Currency details — [Get currency](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Fget) |\n\n## Response example\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"currency\": \"USD\"\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 base currency read |\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## Known specifics\n\nThe method only reads settings. Switching the base currency through it is not available.\n\n## See also\n\n- [List currencies](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flist)\n- [Get currency](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Fget)\n- [Get currency localizations](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Fget)\n","2026-10-13",{},1794739363775]