# catalog.product.service.list URL: https://chugunov.pro/api-bitrix24/catalog/product/service/catalog-product-service-list/ Проверено на Битрикс24 REST API, обновлено 11.09.2026 (ревизия источника fb39d6c). Источник: официальная документация Битрикс24 (bitrix-tools/b24-rest-docs, лицензия MIT, © Bitrix). Справочник независимый, официальной документацией не является. Получить список услуг Scope: `catalog` Кто может выполнять метод: администратор ## Описание Метод возвращает список услуг по фильтру. ## Параметры - `select` `array` — необязательный. Массив со списком полей, которые необходимо выбрать (смотрите поля объекта [catalog_product_service](https://apidocs.bitrix24.ru/api-reference/catalog/data-types.html#catalog_product_service)). Обязательные поля: `id`, `iblockId` - `filter` `object` — необязательный. Объект для фильтрации выбранных услуг в формате `{"field_1": "value_1", ... "field_N": "value_N"}`. Возможные значения для `field` соответствуют полям объекта [catalog_product_service](https://apidocs.bitrix24.ru/api-reference/catalog/data-types.html#catalog_product_service). Обязательные поля: `iblockId`. Ключу можно задать дополнительный префикс, уточняющий поведение фильтра. Возможные значения префикса: - `>=` — больше либо равно - `>` — больше - `<=` — меньше либо равно - `<` — меньше - `%` — LIKE, поиск по подстроке. Символ `%` в значении фильтра передавать не нужно. Поиск ищет подстроку в любой позиции строки - `=%` — LIKE, поиск по подстроке. Символ `%` нужно передавать в значении. Примеры: - `"мол%"` — ищет значения, начинающиеся с «мол» - `"%мол"` — ищет значения, заканчивающиеся на «мол» - `"%мол%"` — ищет значения, где «мол» может быть в любой позиции - `%=` — LIKE (аналогично `=%`) - `!%` — NOT LIKE, поиск по подстроке. Символ `%` в значении фильтра передавать не нужно. Поиск идет с обеих сторон - `!=%` — NOT LIKE, поиск по подстроке. Символ `%` нужно передавать в значении. Примеры: - `"мол%"` — ищет значения, не начинающиеся с «мол» - `"%мол"` — ищет значения, не заканчивающиеся на «мол» - `"%мол%"` — ищет значения, где подстроки «мол» нет в любой позиции - `!%=` — NOT LIKE (аналогично `!=%`) - `=` — равно, точное совпадение (используется по умолчанию). Для поиска IN можно передавать несколько значений массивом - `!=` — не равно - `!` — не равно. Для поиска NOT IN можно передавать несколько значений массивом Для пользовательских полей `propertyN` формат значения в `filter` зависит от типа условия: - если фильтруете свойство типа дата или дата-время по диапазону, используйте префикс в ключе, а значение передавайте в поле `value` - если фильтруете числовое, строковое или списочное пользовательское поле по точному совпадению, передавайте значение напрямую, без `value` - для поиска `IN` и `NOT IN` можно передавать массив значений Примеры фильтрации по пользовательским полям: ```js filter: { iblockId: 14, '>=property424': { value: '2025-05-29T12:00:00+03:00' }, '<=property424': { value: '2025-05-30T13:00:00+03:00' }, property996: 9636, property997: [9636, 568, 570, 9658], } ``` - `order` `object` — необязательный. Объект для сортировки выбранных услуг в формате `{"field_1": "order_1", ... "field_N": "order_N"}`. Возможные значения для `field` соответствуют полям объекта [catalog_product_service](https://apidocs.bitrix24.ru/api-reference/catalog/data-types.html#catalog_product_service). Возможные значения для `order`: - `asc` — в порядке возрастания - `desc` — в порядке убывания - `start` `integer` — необязательный. Параметр используется для управления постраничной навигацией. Размер страницы результатов всегда статичный — 50 записей. Чтобы выбрать вторую страницу результатов, передайте значение `50`. Чтобы выбрать третью страницу результатов — значение `100` и так далее. Формула расчета значения параметра `start`: `start = (N-1) * 50`, где `N` — номер нужной страницы ## Ответ HTTP-статус: 200 ```json { "result": { "services": [ { "active": "Y", "available": "N", "bundle": "N", "code": "service", "createdBy": 1, "dateActiveFrom": "2024-05-28T10:00:00+03:00", "dateActiveTo": "2024-05-29T10:00:00+03:00", "dateCreate": "2024-05-27T10:00:00+03:00", "detailPicture": { "id": "6497", "url": "\/rest\/catalog.product.download?fields%5BfieldName%5D=detailPicture\u0026fields%5BfileId%5D=6497\u0026fields%5BproductId%5D=1265", "urlMachine": "\/rest\/catalog.product.download?fields%5BfieldName%5D=detailPicture\u0026fields%5BfileId%5D=6497\u0026fields%5BproductId%5D=1265" }, "detailText": null, "detailTextType": "text", "iblockId": 23, "iblockSectionId": 47, "id": 1265, "modifiedBy": 1, "name": "Услуга", "previewPicture": { "id": "6496", "url": "\/rest\/catalog.product.download?fields%5BfieldName%5D=previewPicture\u0026fields%5BfileId%5D=6496\u0026fields%5BproductId%5D=1265", "urlMachine": "\/rest\/catalog.product.download?fields%5BfieldName%5D=previewPicture\u0026fields%5BfileId%5D=6496\u0026fields%5BproductId%5D=1265" }, "previewText": null, "previewTextType": "text", "sort": 100, "timestampX": "2024-06-14T11:59:04+03:00", "type": 7, "vatId": 1, "vatIncluded": "Y", "xmlId": "1265" } ] }, "total": 1, "time": { "start": 1718363637.281945, "finish": 1718363637.984081, "duration": 0.7021360397338867, "processing": 0.2966270446777344, "date_start": "2024-06-14T14:13:57+03:00", "date_finish": "2024-06-14T14:13:57+03:00" } } ``` ### Возвращаемые данные - `result` `object`. Корневой элемент ответа - `services` `catalog_product_service[]`. Массив объектов с информацией о выбранных услугах - `total` `integer`. Общее количество найденных записей - `time` `time`. Информация о времени выполнения запроса ## Ошибки HTTP-статус: 400 ```json { "error":200040300010, "error_description":"Access denied" } ``` - `200040300010` — Недостаточно прав для чтения торгового каталога - `0` — Не указаны поля `id`, `iblockId` в полях выбора - `0` — Не указано поле `iblockId` в фильтре - `0` — Другие ошибки (например, фатальные ошибки) ## Примеры запроса ### cURL (Webhook) ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"select":["id","iblockId","name","active","available","bundle","code","createdBy","dateActiveFrom","dateActiveTo","dateCreate","detailPicture","detailText","detailTextType","iblockSectionId","modifiedBy","previewPicture","previewText","previewTextType","sort","timestampX","type","vatId","vatIncluded","xmlId","property94","property95"],"filter":{"iblockId":23,">id":10,"vatId":[1,2]},"order":{"id":"desc"}}' \ https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/catalog.product.service.list ``` ### cURL (OAuth) ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"select":["id","iblockId","name","active","available","bundle","code","createdBy","dateActiveFrom","dateActiveTo","dateCreate","detailPicture","detailText","detailTextType","iblockSectionId","modifiedBy","previewPicture","previewText","previewTextType","sort","timestampX","type","vatId","vatIncluded","xmlId","property94","property95"],"filter":{"iblockId":23,">id":10,"vatId":[1,2]},"order":{"id":"desc"},"auth":"**put_access_token_here**"}' \ https://**put_your_bitrix24_address**/rest/catalog.product.service.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, ISODate } from '@bitrix24/b24jssdk' declare const $b24: B24Frame type ServiceItem = { id: number iblockId: number name: string active: string available: string bundle: string code: string createdBy: number dateActiveFrom: ISODate | null dateActiveTo: ISODate | null dateCreate: ISODate | null detailPicture: { id: string; url: string; urlMachine: string } | null detailText: string | null detailTextType: string iblockSectionId: number modifiedBy: number previewPicture: { id: string; url: string; urlMachine: string } | null previewText: string | null previewTextType: string sort: number timestampX: ISODate | null type: number vatId: number vatIncluded: string xmlId: string } // Shape of the payload returned in result (match the "response handling" section of the page) type ServiceListResult = { services: ServiceItem[] } try { // catalog.product.service.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. const response = await $b24.actions.v2.call.make({ method: 'catalog.product.service.list', params: { select: [ 'id', 'iblockId', 'name', 'active', 'available', 'bundle', 'code', 'createdBy', 'dateActiveFrom', 'dateActiveTo', 'dateCreate', 'detailPicture', 'detailText', 'detailTextType', 'iblockSectionId', 'modifiedBy', 'previewPicture', 'previewText', 'previewTextType', 'sort', 'timestampX', 'type', 'vatId', 'vatIncluded', 'xmlId', 'property94', 'property95', ], filter: { iblockId: 23, '>id': 10, vatId: [1, 2], }, order: { id: 'desc', }, 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('Services on this page:', result.services.length, result.services) } } 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.service.list( select=[ "id", "iblockId", "name", "active", "available", "bundle", "code", "createdBy", "dateActiveFrom", "dateActiveTo", "dateCreate", "detailPicture", "detailText", "detailTextType", "iblockSectionId", "modifiedBy", "previewPicture", "previewText", "previewTextType", "sort", "timestampX", "type", "vatId", "vatIncluded", "xmlId", "property94", "property95", ], filter={ "iblockId": 23, ">id": 10, "vatId": [ 1, 2, ], }, order={ "id": "desc", }, 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.product.service.list', [ 'select' => [ 'id', 'iblockId', 'name', 'active', 'available', 'bundle', 'code', 'createdBy', 'dateActiveFrom', 'dateActiveTo', 'dateCreate', 'detailPicture', 'detailText', 'detailTextType', 'iblockSectionId', 'modifiedBy', 'previewPicture', 'previewText', 'previewTextType', 'sort', 'timestampX', 'type', 'vatId', 'vatIncluded', 'xmlId', 'property94', 'property95', ], 'filter' => [ 'iblockId' => 23, '>id' => 10, 'vatId' => [1, 2], ], 'order' => [ 'id' => 'desc', ], ] ); $result = $response ->getResponseData() ->getResult(); echo 'Success: ' . print_r($result, true); } catch (Throwable $e) { error_log($e->getMessage()); echo 'Error fetching product list: ' . $e->getMessage(); } ``` ### BX24.js ```js BX24.callMethod( "catalog.product.service.list", { "select": [ "id", "iblockId", "name", "active", "available", "bundle", "code", "createdBy", "dateActiveFrom", "dateActiveTo", "dateCreate", "detailPicture", "detailText", "detailTextType", "iblockSectionId", "modifiedBy", "previewPicture", "previewText", "previewTextType", "sort", "timestampX", "type", "vatId", "vatIncluded", "xmlId", "property94", "property95", ], "filter": { "iblockId": 23, ">id": 10, "vatId": [1, 2], }, "order": { "id": "desc", } }, function(result) { if (result.error()) { console.error(result.error()); } else { console.info(result.data()); } } ); ``` ### PHP CRest ```php require_once('crest.php'); $result = CRest::call( 'catalog.product.service.list', [ 'select' => [ 'id', 'iblockId', 'name', 'active', 'available', 'bundle', 'code', 'createdBy', 'dateActiveFrom', 'dateActiveTo', 'dateCreate', 'detailPicture', 'detailText', 'detailTextType', 'iblockSectionId', 'modifiedBy', 'previewPicture', 'previewText', 'previewTextType', 'sort', 'timestampX', 'type', 'vatId', 'vatIncluded', 'xmlId', 'property94', 'property95', ], 'filter' => [ 'iblockId' => 23, '>id' => 10, 'vatId' => [1, 2], ], 'order' => [ 'id' => 'desc', ] ] ); echo '
';
print_r($result);
echo '
'; ``` ### Go ```go // client и ctx уже созданы — см. раздел «SDK для Go» res, err := client.Core().Call(ctx, "catalog.product.service.list", b24.Params{ "select": []string{"id", "iblockId", "name", "active", "available", "bundle", "code", "createdBy", "dateActiveFrom", "dateActiveTo", "dateCreate", "detailPicture", "detailText", "detailTextType", "iblockSectionId", "modifiedBy", "previewPicture", "previewText", "previewTextType", "sort", "timestampX", "type", "vatId", "vatIncluded", "xmlId", "property94", "property95"}, "filter": b24.Params{ "iblockId": 23, ">id": 10, "vatId": []int{1, 2}, }, "order": b24.Params{ "id": "desc", }, }, b24.WithIdempotent()) if err != nil { return fmt.Errorf("catalog.product.service.list: %w", err) } // Метод заворачивает ответ в объект с ключом "services". raw, ok := b24.Unwrap(res.Result, "services") if !ok { return fmt.Errorf("в ответе нет ключа services") } var items []struct { Active string `json:"active"` Available string `json:"available"` Bundle string `json:"bundle"` Code string `json:"code"` CreatedBy int `json:"createdBy"` DateActiveFrom string `json:"dateActiveFrom"` } if err := json.Unmarshal(raw, &items); err != nil { return fmt.Errorf("разбор ответа: %w", err) } for _, it := range items { fmt.Println(it.Active) } ``` Оригинал в официальной документации: https://apidocs.bitrix24.ru/api-reference/catalog/product/service/catalog-product-service-list.html