[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Fbasket-items\u002Fget":3,"docs-tabs-entities\u002Fbasket-items\u002Fget":6},{"content":4,"lastmod":5},"\n## Получить позицию корзины\n\n`GET \u002Fv1\u002Fbasket-items\u002F:id`\n\nВозвращает одну позицию корзины по идентификатору со всеми полями.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | Описание |\n|----------|-----|:-----:|---------|\n| `id` (path) | number | да | Идентификатор позиции |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbasket-items\u002F9\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbasket-items\u002F9\" \\\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\u002Fbasket-items\u002F9', {\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n  },\n})\n\nconst { success, data } = await res.json()\nconsole.log('Позиция:', data.name, '×', data.quantity, '=', data.price * data.quantity, data.currency)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbasket-items\u002F9', {\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| Поле | Тип | Описание |\n|------|-----|---------|\n| `id` | number | Идентификатор позиции |\n| `orderId` | number \\| null | Идентификатор заказа. `null` у свободных позиций без заказа |\n| `productId` | number | Идентификатор товара в каталоге |\n| `name` | string | Название товара |\n| `price` | number | Цена за единицу |\n| `basePrice` | number | Базовая цена до скидки |\n| `discountPrice` | number | Размер скидки за единицу |\n| `currency` | string | Валюта |\n| `quantity` | number | Количество |\n| `sort` | number | Порядок позиции в корзине |\n| `weight` | number \\| null | Вес в граммах. `null` у виртуальных позиций с `productId: 0` |\n| `vatRate` | number \\| null | Ставка НДС в долях единицы. `null` у виртуальных позиций с `productId: 0` |\n| `vatIncluded` | boolean | Включён ли НДС в цену |\n| `customPrice` | boolean | Защита цены от автопересчёта при изменении товара в каталоге |\n| `canBuy` | boolean | Доступен ли товар к покупке |\n| `barcodeMulti` | boolean | Позиция учитывается по нескольким штрихкодам |\n| `measureCode` | number \\| null | Код единицы измерения. `null` у виртуальных позиций с `productId: 0` |\n| `measureName` | string \\| null | Название единицы измерения. `null` у виртуальных позиций с `productId: 0` |\n| `dimensions` | string \\| null | Габариты в формате сериализации PHP. `null` у виртуальных позиций с `productId: 0` |\n| `xmlId` | string | Внешний идентификатор позиции |\n| `productXmlId` | string \\| null | Внешний идентификатор товара в каталоге. `null` у виртуальных позиций с `productId: 0` |\n| `catalogXmlId` | string \\| null | Внешний идентификатор каталога. `null` у виртуальных позиций с `productId: 0` |\n| `type` | string \\| null | Тип позиции. На живых порталах всегда `null` |\n| `properties` | array | Свойства позиции. Каждый элемент: `{basketId, code, id, name, sort, value, xmlId}` |\n| `reservations` | array | Резервы позиции на складах |\n| `dateInsert` | datetime | Дата создания |\n| `dateUpdate` | datetime | Дата последнего изменения |\n\nПолный список полей — [`GET \u002Fv1\u002Fbasket-items\u002Ffields`](.\u002Ffields.md).\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": 9,\n    \"orderId\": 33,\n    \"productId\": 119,\n    \"name\": \"Домашние Тапочки Любимый Спорт\",\n    \"price\": 470,\n    \"basePrice\": 470,\n    \"discountPrice\": 0,\n    \"currency\": \"RUB\",\n    \"quantity\": 1,\n    \"weight\": 0,\n    \"vatRate\": 0,\n    \"vatIncluded\": true,\n    \"customPrice\": false,\n    \"canBuy\": true,\n    \"barcodeMulti\": false,\n    \"measureCode\": 796,\n    \"measureName\": \"шт\",\n    \"dimensions\": \"a:3:{s:5:\\\"WIDTH\\\";N;s:6:\\\"HEIGHT\\\";N;s:6:\\\"LENGTH\\\";N;}\",\n    \"xmlId\": \"bx_5fc9f8c57fe6c\",\n    \"productXmlId\": \"1000000475\",\n    \"catalogXmlId\": \"FUTURE-1C-CATALOG\",\n    \"type\": null,\n    \"sort\": 200,\n    \"properties\": [\n      {\n        \"id\": 17,\n        \"basketId\": 9,\n        \"code\": \"CATALOG.XML_ID\",\n        \"name\": \"Catalog XML_ID\",\n        \"value\": \"FUTURE-1C-CATALOG\",\n        \"sort\": 100,\n        \"xmlId\": \"bx_5fc9f8c57ff3e\"\n      },\n      {\n        \"id\": 19,\n        \"basketId\": 9,\n        \"code\": \"PRODUCT.XML_ID\",\n        \"name\": \"Product XML_ID\",\n        \"value\": \"1000000475\",\n        \"sort\": 100,\n        \"xmlId\": \"bx_5fc9f8c57ffb2\"\n      }\n    ],\n    \"reservations\": [],\n    \"dateInsert\": \"2020-12-04T07:52:21.000Z\",\n    \"dateUpdate\": \"2022-11-02T05:10:13.000Z\"\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n422 — позиция не найдена:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ERROR\",\n    \"message\": \"basket item is not exists\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 422 | `BITRIX_ERROR` | Позиция с таким ID не найдена |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `sale` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Обновить позицию](.\u002Fupdate.md)\n- [Удалить позицию](.\u002Fdelete.md)\n- [Список позиций](.\u002Flist.md)\n- [Поля позиции](.\u002Ffields.md)\n- [Заказ](..\u002Forders\u002Fget.md)\n- [Лимиты и оптимизация](\u002Fdocs\u002Foptimization)\n","2026-07-09",{}]