[{"data":1,"prerenderedAt":7},["ShallowReactive",2],{"docs-entities\u002Fbasket-item-properties":3,"docs-tabs-entities\u002Fbasket-item-properties":6},{"content":4,"lastmod":5},"# Basket item properties\n\nProperties of a specific basket item: name, value, symbolic code, and sort order.\n\nBitrix24 API: `sale.basketproperties.*`\nScope: `sale`\n\n## Operations\n\n- [Create a basket item property](\u002Fdocs\u002Fentities\u002Fbasket-item-properties\u002Fcreate) — `POST \u002Fv1\u002Fbasket-item-properties`\n- [List basket item properties](\u002Fdocs\u002Fentities\u002Fbasket-item-properties\u002Flist) — `GET \u002Fv1\u002Fbasket-item-properties`\n- [Get a basket item property](\u002Fdocs\u002Fentities\u002Fbasket-item-properties\u002Fget) — `GET \u002Fv1\u002Fbasket-item-properties\u002F:id`\n- [Update a basket item property](\u002Fdocs\u002Fentities\u002Fbasket-item-properties\u002Fupdate) — `PATCH \u002Fv1\u002Fbasket-item-properties\u002F:id`\n- [Delete a basket item property](\u002Fdocs\u002Fentities\u002Fbasket-item-properties\u002Fdelete) — `DELETE \u002Fv1\u002Fbasket-item-properties\u002F:id`\n- [Search basket item properties](\u002Fdocs\u002Fentities\u002Fbasket-item-properties\u002Fsearch) — `POST \u002Fv1\u002Fbasket-item-properties\u002Fsearch`\n- [Basket item property fields](\u002Fdocs\u002Fentities\u002Fbasket-item-properties\u002Ffields) — `GET \u002Fv1\u002Fbasket-item-properties\u002Ffields`\n- [Aggregate basket item properties](\u002Fdocs\u002Fentities\u002Fbasket-item-properties\u002Faggregate) — `POST \u002Fv1\u002Fbasket-item-properties\u002Faggregate`\n\n## Key fields\n\n| Field | Type | Description |\n|------|-----|---------|\n| `id` | number | Property ID. List: [`GET \u002Fv1\u002Fbasket-item-properties`](.\u002Fbasket-item-properties\u002Flist.md). Read-only |\n| `basketId` | number | Basket item ID from [`GET \u002Fv1\u002Fbasket-items`](\u002Fdocs\u002Fentities\u002Fbasket-items\u002Flist). Required on creation, cannot be changed through `PATCH` |\n| `name` | string | Property name. Required on creation |\n| `value` | string \\| null | Property value. Required on creation |\n| `code` | string \\| null | Property symbolic code. Required on creation |\n| `sort` | number | Sort order of the property within the item |\n| `xmlId` | string \\| null | External ID |\n\nFor the complete field list, see [`GET \u002Fv1\u002Fbasket-item-properties\u002Ffields`](.\u002Fbasket-item-properties\u002Ffields.md).\n\n## Before you start\n\n1. **Reading properties in an item and writing them use separate methods.** [`GET \u002Fv1\u002Fbasket-items\u002F:id`](\u002Fdocs\u002Fentities\u002Fbasket-items\u002Fget) returns properties in the read-only `properties` field. Use the methods in this section to create, update, and delete properties.\n2. **Select an order's properties through its basket items.** Get item IDs using [`GET \u002Fv1\u002Fbasket-items`](\u002Fdocs\u002Fentities\u002Fbasket-items\u002Flist) with an `orderId` filter. Source of `orderId`: [`GET \u002Fv1\u002Forders`](\u002Fdocs\u002Fentities\u002Forders\u002Flist). Then pass the item IDs in the `basketId` filter of [list](.\u002Fbasket-item-properties\u002Flist.md) or [search](.\u002Fbasket-item-properties\u002Fsearch.md).\n3. **Partial updates preserve omitted fields.** If `PATCH` omits `name`, `code`, or `value`, Vibecode reads the property and fills in the stored values. For batch updates, pass all three fields explicitly for each property. For the format, see [Batch calls](\u002Fdocs\u002Fbatch).\n4. **Creating and deleting a property saves the order.** The order that owns the basket item has its `dateUpdate` and `version` updated.\n\n## Typical workflow\n\n1. Select a basket item and get its `id`: [`GET \u002Fv1\u002Fbasket-items`](\u002Fdocs\u002Fentities\u002Fbasket-items\u002Flist).\n2. Check its properties with a `basketId` filter: [`GET \u002Fv1\u002Fbasket-item-properties`](.\u002Fbasket-item-properties\u002Flist.md).\n3. Create a property with `basketId`, `name`, `value`, and `code`: [`POST \u002Fv1\u002Fbasket-item-properties`](.\u002Fbasket-item-properties\u002Fcreate.md).\n4. Read the property by its returned `id`: [`GET \u002Fv1\u002Fbasket-item-properties\u002F:id`](.\u002Fbasket-item-properties\u002Fget.md).\n5. Update the value: [`PATCH \u002Fv1\u002Fbasket-item-properties\u002F:id`](.\u002Fbasket-item-properties\u002Fupdate.md).\n6. Delete the property when it is no longer needed: [`DELETE \u002Fv1\u002Fbasket-item-properties\u002F:id`](.\u002Fbasket-item-properties\u002Fdelete.md).\n\n## Limits\n\n| Limit | Value |\n|-------|----------|\n| Records per list or search request | `limit` from 1 to 5000, default 50. Use `offset` for the following records. See [List basket item properties](.\u002Fbasket-item-properties\u002Flist.md) and [Search basket item properties](.\u002Fbasket-item-properties\u002Fsearch.md) |\n| Automatic pagination | With `limit > 50`, Vibecode reads Bitrix24 pages of 50 records and merges them into one response. See [List](.\u002Fbasket-item-properties\u002Flist.md) |\n| Batch calls | `POST \u002Fv1\u002Fbatch` and `POST \u002Fv1\u002Fbasket-item-properties\u002Fbatch`. Defaults: up to 500 items for writes and up to 50 calls for reads. Platform settings can change these limits. For the format, see [Batch calls](\u002Fdocs\u002Fbatch) |\n| Request rate | Shared Vibecode API limit — see [Limits and optimization](\u002Fdocs\u002Foptimization) |\n\n## See also\n\n- [Basket items](\u002Fdocs\u002Fentities\u002Fbasket-items)\n- [Orders](\u002Fdocs\u002Fentities\u002Forders)\n- [Filtering syntax](\u002Fdocs\u002Ffiltering)\n- [Entity API](\u002Fdocs\u002Fentity-api)\n- [Batch calls](\u002Fdocs\u002Fbatch)\n","2026-10-12",{},1795000263876]