# catalog.productPropertyFeature.list URL: https://chugunov.pro/api-bitrix24/catalog/product-property-feature/catalog-product-property-feature-list/ Проверено на Битрикс24 REST API, обновлено 11.09.2026 (ревизия источника fb39d6c). Источник: официальная документация Битрикс24 (bitrix-tools/b24-rest-docs, лицензия MIT, © Bitrix). Справочник независимый, официальной документацией не является. Получить список параметров свойств товаров или вариаций Scope: `catalog` Кто может выполнять метод: пользователь с правом «Просмотр каталога товаров» ## Описание Метод `catalog.productPropertyFeature.list` возвращает список параметров свойств товаров и вариаций по фильтру. ## Параметры - `select` `array` — необязательный. Массив, содержащий список полей, которые необходимо выбрать (смотрите поля объекта [catalog_product_property_features](https://apidocs.bitrix24.ru/api-reference/catalog/data-types.html#catalog_product_property_features)). Если параметр не передан, будут выбраны все поля - `filter` `object` — необязательный. Объект для фильтрации выбранных параметров в формате `{"field_1": "value_1", ... "field_N": "value_N"}`. Возможные значения для `field` соответствуют полям объекта [catalog_product_property_features](https://apidocs.bitrix24.ru/api-reference/catalog/data-types.html#catalog_product_property_features). Ключу может быть задан дополнительный префикс, уточняющий поведение фильтра. Возможные значения префикса: - `>=` — больше либо равно - `>` — больше - `<=` — меньше либо равно - `<` — меньше - `%` — LIKE, поиск по подстроке. Символ `%` в значении фильтра передавать не нужно - `=%` — LIKE, поиск по подстроке. Символ `%` нужно передавать в значении - `%=` — LIKE (аналогично `=%`) - `!%` — NOT LIKE, поиск по подстроке. Символ `%` в значении фильтра передавать не нужно - `!=%` — NOT LIKE, поиск по подстроке. Символ `%` нужно передавать в значении - `!%=` — NOT LIKE (аналогично `!=%`) - `=` — равно, точное совпадение (используется по умолчанию) - `!=` — не равно - `!` — не равно Если `propertyId` не передан, метод выбирает параметры всех свойств торговых каталогов. Если передан `propertyId`, который не существует или не относится к торговому каталогу, метод вернет пустой список - `order` `object` — необязательный. Объект для сортировки выбранных параметров в формате `{"field_1": "order_1", ... "field_N": "order_N"}`. Возможные значения для `field` соответствуют полям объекта [catalog_product_property_features](https://apidocs.bitrix24.ru/api-reference/catalog/data-types.html#catalog_product_property_features). Возможные значения для `order`: - `ASC` — в порядке возрастания - `DESC` — в порядке убывания Если параметр не передан, применяется сортировка `id ASC` - `start` `integer` — необязательный. Параметр используется для управления постраничной навигацией. Размер страницы результатов всегда статичный — 50 записей. Чтобы выбрать вторую страницу результатов, передайте значение `50`. Чтобы выбрать третью страницу результатов — `100` и так далее. Формула расчета значения параметра `start`: `start = (N - 1) * 50`, где `N` — номер нужной страницы. Если передать значение `-1`, в ответе не будет поля `total` ## Ответ HTTP-статус: 200 ```json { "result": { "productPropertyFeatures": [ { "featureId": "DETAIL_PAGE_SHOW", "id": 99, "isEnabled": "Y", "moduleId": "iblock", "propertyId": 901 }, { "featureId": "LIST_PAGE_SHOW", "id": 101, "isEnabled": "Y", "moduleId": "iblock", "propertyId": 901 } ] }, "total": 2, "time": { "start": 1774254804, "finish": 1774254805.034701, "duration": 1.0347011089324951, "processing": 1, "date_start": "2026-03-23T11:33:24+03:00", "date_finish": "2026-03-23T11:33:25+03:00", "operating_reset_at": 1774255404, "operating": 0 } } ``` ### Возвращаемые данные - `result` `object`. Корневой объект ответа - `productPropertyFeatures` `catalog_product_property_features[]`. Массив объектов с информацией о выбранных параметрах - `next` `integer`. Смещение для следующей страницы. Поле возвращается, если есть еще записи - `total` `integer`. Общее число записей. Поле не возвращается, если запрос выполнен со `start = -1` - `time` `time`. Информация о времени выполнения запроса ## Ошибки HTTP-статус: 400 ```json { "error": "0", "error_description": "Access Denied" } ``` - `0` — Access Denied. Недостаточно прав для просмотра каталога - `100` — Invalid value {wrong_type} to match with parameter {filter}. Should be value of type array.. Неверный тип данных у значения параметра `filter` - `100` — Invalid value {wrong_type} to match with parameter {select}. Should be value of type array.. Неверный тип данных у значения параметра `select` - `100` — Invalid value {wrong_type} to match with parameter {order}. Should be value of type array.. Неверный тип данных у значения параметра `order` ## Примеры запроса ### cURL (Webhook) ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"select":["id","propertyId","moduleId","featureId","isEnabled"],"filter":{"propertyId":901},"order":{"id":"ASC"}}' \ https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/catalog.productPropertyFeature.list ``` ### cURL (OAuth) ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"select":["id","propertyId","moduleId","featureId","isEnabled"],"filter":{"propertyId":901},"order":{"id":"ASC"},"auth":"**put_access_token_here**"}' \ https://**put_your_bitrix24_address**/rest/catalog.productPropertyFeature.list ``` ### JS (TS) ```ts // This snippet is an ES module: top-level await requires type="module" or a bundler. // $b24 is an already-initialized SDK instance (see the SDK "Get started" guide). import { Text } from '@bitrix24/b24jssdk' import type { B24Frame } from '@bitrix24/b24jssdk' declare const $b24: B24Frame // Shape of the payload returned in result (match the "response handling" section of the page) type ProductPropertyFeatureListResult = { productPropertyFeatures: { id: number propertyId: number moduleId: string featureId: string isEnabled: string }[] } // catalog.productPropertyFeature.list returns a single page (max 50 records). For the whole result set // use a list helper: $b24.actions.v2.callList.make() returns every record as one // array, $b24.actions.v2.fetchList.make() yields them in chunks (async generator). // NOTE: the list helpers do not accept `order` (it is excluded from their params, so // passing it is a TS error) — keep this call.make + `start` variant when sort matters. try { const response = await $b24.actions.v2.call.make({ method: 'catalog.productPropertyFeature.list', params: { select: ['id', 'propertyId', 'moduleId', 'featureId', 'isEnabled'], filter: { propertyId: 901 }, order: { id: 'ASC' }, start: 0, }, requestId: Text.getUuidRfc4122() }) // The payload is available only on a successful response if (!response.isSuccess) { console.error(response.getErrorMessages().join('; ')) } else { const result = response.getData()!.result console.info(result.productPropertyFeatures.length, result.productPropertyFeatures) } } catch (error) { // Thrown on transport or SDK failures (AjaxError, SdkError, etc.) console.error(error) } ``` ### JS (UMD) ```html ``` ### Python ```python from b24pysdk.errors import BitrixAPIError, BitrixSDKException try: bitrix_response = client.catalog.product_property_feature.list( select=[ "id", "propertyId", "moduleId", "featureId", "isEnabled", ], filter={ "propertyId": 901, }, order={ "id": "ASC", }, start=0, ).response result = bitrix_response.result print(result) except BitrixAPIError as error: print( "Ошибка Bitrix API", f"error: {error.error}", f"error_description: {error.error_description}", sep="\n", ) except BitrixSDKException as error: print(f"Ошибка Bitrix SDK: {error.message}") except Exception as error: print(f"Непредвиденная ошибка: {error}") ``` ### PHP ```php try { $response = $b24Service ->core ->call( 'catalog.productPropertyFeature.list', [ 'select' => ['id', 'propertyId', 'moduleId', 'featureId', 'isEnabled'], 'filter' => [ 'propertyId' => 901, ], 'order' => ['id' => 'ASC'], ] ); print_r($response->getResponseData()->getResult()); } catch (\Throwable $exception) { echo $exception->getMessage(); } ``` ### BX24.js ```js BX24.callMethod( 'catalog.productPropertyFeature.list', { select: ['id', 'propertyId', 'moduleId', 'featureId', 'isEnabled'], filter: { propertyId: 901 }, order: { id: 'ASC' } }, function(result) { if (result.error()) { console.error(result.error()); } else { console.log(result.data()); } } ); ``` ### PHP CRest ```php require_once('crest.php'); $result = CRest::call( 'catalog.productPropertyFeature.list', [ 'select' => ['id', 'propertyId', 'moduleId', 'featureId', 'isEnabled'], 'filter' => ['propertyId' => 901], 'order' => ['id' => 'ASC'], ] ); print_r($result); ``` ### Go ```go // client и ctx уже созданы — см. раздел «SDK для Go» res, err := client.Core().Call(ctx, "catalog.productPropertyFeature.list", b24.Params{ "select": []string{"id", "propertyId", "moduleId", "featureId", "isEnabled"}, "filter": b24.Params{ "propertyId": 901, }, "order": b24.Params{ "id": "ASC", }, }, b24.WithIdempotent()) if err != nil { return fmt.Errorf("catalog.productPropertyFeature.list: %w", err) } // Метод заворачивает ответ в объект с ключом "productPropertyFeatures". raw, ok := b24.Unwrap(res.Result, "productPropertyFeatures") if !ok { return fmt.Errorf("в ответе нет ключа productPropertyFeatures") } var items []struct { FeatureID string `json:"featureId"` ID b24.ID `json:"id"` IsEnabled string `json:"isEnabled"` ModuleID string `json:"moduleId"` PropertyID b24.ID `json:"propertyId"` } if err := json.Unmarshal(raw, &items); err != nil { return fmt.Errorf("разбор ответа: %w", err) } for _, it := range items { fmt.Println(it.FeatureID) } ``` Оригинал в официальной документации: https://apidocs.bitrix24.ru/api-reference/catalog/product-property-feature/catalog-product-property-feature-list.html