[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Faddresses\u002Ffields":3,"docs-tabs-entities\u002Faddresses\u002Ffields":6},{"content":4,"lastmod":5},"\n## Поля адреса\n\n`GET \u002Fv1\u002Faddresses\u002Ffields`\n\nВозвращает схему полей адреса — список всех допустимых полей с типами, признаками обязательности и доступности для записи.\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Faddresses\u002Ffields\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Faddresses\u002Ffields\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Faddresses\u002Ffields', {\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n  },\n})\n\nconst { success, data } = await res.json()\nconst fieldNames = Object.keys(data.fields)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Faddresses\u002Ffields', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\n\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Битрикс24 | Тип | RO | Описание |\n|------|-----------|-----|----|---------|\n| `typeId` | `TYPE_ID` | number | — | Тип адреса. Обязательный, неизменяемый после создания |\n| `entityTypeId` | `ENTITY_TYPE_ID` | number | — | Тип владельца адреса. Обязательный, неизменяемый после создания |\n| `entityId` | `ENTITY_ID` | number | — | ID владельца адреса. Обязательный, неизменяемый после создания |\n| `address1` | `ADDRESS_1` | string | — | Улица, дом, корпус, строение |\n| `address2` | `ADDRESS_2` | string | — | Квартира, офис |\n| `city` | `CITY` | string | — | Город |\n| `postalCode` | `POSTAL_CODE` | string | — | Почтовый индекс |\n| `region` | `REGION` | string | — | Район |\n| `province` | `PROVINCE` | string | — | Область |\n| `country` | `COUNTRY` | string | — | Страна |\n| `countryCode` | `COUNTRY_CODE` | string | — | Код страны |\n| `locAddrId` | `LOC_ADDR_ID` | number | — | Идентификатор адреса местоположения |\n| `anchorTypeId` | `ANCHOR_TYPE_ID` | number | да | Тип сущности, к которой привязан адрес |\n| `anchorId` | `ANCHOR_ID` | number | да | ID сущности, к которой привязан адрес |\n\nRO — поле доступно только для чтения. Колонка «Битрикс24» — имя того же поля в Битрикс24.\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"fields\": {\n      \"typeId\": {\n        \"type\": \"integer\",\n        \"isRequired\": true,\n        \"isReadOnly\": false,\n        \"isImmutable\": true,\n        \"isMultiple\": false,\n        \"isDynamic\": false,\n        \"title\": \"TYPE_ID\"\n      },\n      \"entityTypeId\": {\n        \"type\": \"integer\",\n        \"isRequired\": true,\n        \"isReadOnly\": false,\n        \"isImmutable\": true,\n        \"isMultiple\": false,\n        \"isDynamic\": false,\n        \"title\": \"ENTITY_TYPE_ID\"\n      },\n      \"entityId\": {\n        \"type\": \"integer\",\n        \"isRequired\": true,\n        \"isReadOnly\": false,\n        \"isImmutable\": true,\n        \"isMultiple\": false,\n        \"isDynamic\": false,\n        \"title\": \"ENTITY_ID\"\n      },\n      \"address1\": {\n        \"type\": \"string\",\n        \"isRequired\": false,\n        \"isReadOnly\": false,\n        \"isImmutable\": false,\n        \"isMultiple\": false,\n        \"isDynamic\": false,\n        \"title\": \"Улица, дом, корпус, строение\"\n      },\n      \"address2\": {\n        \"type\": \"string\",\n        \"isRequired\": false,\n        \"isReadOnly\": false,\n        \"isImmutable\": false,\n        \"isMultiple\": false,\n        \"isDynamic\": false,\n        \"title\": \"Квартира \u002F офис\"\n      },\n      \"city\": {\n        \"type\": \"string\",\n        \"isRequired\": false,\n        \"isReadOnly\": false,\n        \"isImmutable\": false,\n        \"isMultiple\": false,\n        \"isDynamic\": false,\n        \"title\": \"Город\"\n      },\n      \"postalCode\": {\n        \"type\": \"string\",\n        \"isRequired\": false,\n        \"isReadOnly\": false,\n        \"isImmutable\": false,\n        \"isMultiple\": false,\n        \"isDynamic\": false,\n        \"title\": \"Почтовый индекс\"\n      },\n      \"region\": {\n        \"type\": \"string\",\n        \"isRequired\": false,\n        \"isReadOnly\": false,\n        \"isImmutable\": false,\n        \"isMultiple\": false,\n        \"isDynamic\": false,\n        \"title\": \"Район\"\n      },\n      \"province\": {\n        \"type\": \"string\",\n        \"isRequired\": false,\n        \"isReadOnly\": false,\n        \"isImmutable\": false,\n        \"isMultiple\": false,\n        \"isDynamic\": false,\n        \"title\": \"Область\"\n      },\n      \"country\": {\n        \"type\": \"string\",\n        \"isRequired\": false,\n        \"isReadOnly\": false,\n        \"isImmutable\": false,\n        \"isMultiple\": false,\n        \"isDynamic\": false,\n        \"title\": \"Страна\"\n      },\n      \"countryCode\": {\n        \"type\": \"string\",\n        \"isRequired\": false,\n        \"isReadOnly\": false,\n        \"isImmutable\": false,\n        \"isMultiple\": false,\n        \"isDynamic\": false,\n        \"title\": \"COUNTRY_CODE\"\n      },\n      \"locAddrId\": {\n        \"type\": \"integer\",\n        \"isRequired\": false,\n        \"isReadOnly\": false,\n        \"isImmutable\": false,\n        \"isMultiple\": false,\n        \"isDynamic\": false,\n        \"title\": \"Идентификатор адреса местоположения\"\n      },\n      \"anchorTypeId\": {\n        \"type\": \"integer\",\n        \"isRequired\": false,\n        \"isReadOnly\": true,\n        \"isImmutable\": false,\n        \"isMultiple\": false,\n        \"isDynamic\": false,\n        \"title\": \"ANCHOR_TYPE_ID\"\n      },\n      \"anchorId\": {\n        \"type\": \"integer\",\n        \"isRequired\": false,\n        \"isReadOnly\": true,\n        \"isImmutable\": false,\n        \"isMultiple\": false,\n        \"isDynamic\": false,\n        \"title\": \"ANCHOR_ID\"\n      }\n    }\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n403 — у API-ключа нет скоупа `crm`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SCOPE_DENIED\",\n    \"message\": \"This endpoint requires 'crm' scope\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `crm` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Поля `typeId`, `entityTypeId`, `entityId` — неизменяемые.** Флаг `isImmutable: true` означает, что после создания адреса эти поля нельзя изменить. Они задают составной ключ и не передаются в теле запросов на обновление.\n\n## Смотрите также\n\n- [Получить адрес](\u002Fdocs\u002Fentities\u002Faddresses\u002Fget)\n- [Список адресов](\u002Fdocs\u002Fentities\u002Faddresses\u002Flist)\n- [Поля реквизита](\u002Fdocs\u002Fentities\u002Frequisites\u002Ffields)\n- [Адреса](\u002Fdocs\u002Fentities\u002Faddresses)\n","2026-07-14",{}]