# Basket item properties

Methods: `sale.basketproperties.*`. Scope: `sale`.

## Operations

- [Create](./basket-item-properties/create.md): `POST /v1/basket-item-properties`
- [List](./basket-item-properties/list.md): `GET /v1/basket-item-properties`
- [Get](./basket-item-properties/get.md): `GET /v1/basket-item-properties/:id`
- [Update](./basket-item-properties/update.md): `PATCH /v1/basket-item-properties/:id`
- [Delete](./basket-item-properties/delete.md): `DELETE /v1/basket-item-properties/:id`
- [Search](./basket-item-properties/search.md): `POST /v1/basket-item-properties/search`
- [Fields](./basket-item-properties/fields.md): `GET /v1/basket-item-properties/fields`
- [Aggregate: Basket item properties](./basket-item-properties/aggregate.md): `POST /v1/basket-item-properties/aggregate`

## Usage notes

Properties of an individual basket item. Read them on the [basket item card](/docs/entities/basket-items), where properties is read-only. Use this section to create, update, delete or list properties across items with a basketId filter. Creation requires basketId, name, value and code. basketId is read-only on PATCH. Missing basket item: 404; business refusal: 422. Bitrix24 saves the entire order when a property is written or deleted: discounts, the modification date and order automation may change. Prices and discounts depend on portal settings.

Y/N flags accept and return booleans. Missing record: 404 ENTITY_NOT_FOUND. Business refusal: 422 with the Bitrix24 message. Empty POST: 400 MISSING_REQUIRED_FIELDS. A READONLY key cannot write (403). Lists support filter, select, sort, limit, offset; Bitrix24 pages contain 50 rows and V1 fetches more automatically when limit > 50.

`POST /v1/batch`, `POST /v1/basket-item-properties/batch`.

PATCH reads name, code and value, which Bitrix24 requires on every update, and supplies omitted values. In batch requests, supply these three fields explicitly.