Список локаций с фильтрами и пагинацией

POST /v1/location/list

POST/v1/location/list

Тело запроса

filter
object
required
Фильтр. Если поле фильтра не передано, равно null или передан пустой массив [], фильтрация по этому полю не применяется. При одновременном указании нескольких фильтров условия объединяются по AND.
Показать свойства
location_id
array
Фильтр по идентификаторам локации.
location_types
array
Фильтр по типам локации. В выборку попадают локации, у которых в массиве location_types есть хотя бы один из указанных типов (WAREHOUSE, PICKUP_POINT, CLICK_AND_COLLECT).
Тип локации в массиве location_types. - WAREHOUSE: склад. - PICKUP_POINT: пункт выдачи. - CLICK_AND_COLLECT: пункт самовывоза (Click & Collect).
status
array
Фильтр по статусам локации. В выборку попадают локации, чей статус входит в указанный набор.
Статус локации в витрине. - DRAFT: создан. - PENDING: в обработке. - ACTIVE: включена, доступна к выбору. - QUARANTINE: карантин. - FAILED: не прошёл модерацию. - ARCHIVED: перенесён в архив.
cursor
string
Курсор начала отсчёта.
limit
integer
required
Размер страницы. min = 1; max = 300; default = 100.

Успешный ответ

200A successful response.
application/json
object
locations
array
required
Элементы списка. Локации с недоступными или несуществующими location_id в ответ не возвращаются.
Показать свойства
location_id
string
required
Идентификатор локации.
merchant_location_id
string
Идентификатор локации продавца.
location_types
array
required
Типы локации; элементы — WAREHOUSE (склад), PICKUP_POINT (пункт выдачи) или CLICK_AND_COLLECT (пункт самовывоза). Набор определяет допустимую схему данных и валидацию полей локации.
Тип локации в массиве location_types. - WAREHOUSE: склад. - PICKUP_POINT: пункт выдачи. - CLICK_AND_COLLECT: пункт самовывоза (Click & Collect).
name
string
required
Название локации.
status
string
required
Статус локации в витрине.
Допустимые значения
DRAFTPENDINGACTIVEQUARANTINEFAILEDARCHIVED
issue
object
Проблема по локации; пустой объект или не передаётся при статусах DRAFT и ACTIVE.
Показать свойства
code
string
required
Код проблемы.
message
string
required
Детальное описание проблемы.
changed_at
string
required
Момент изменения (RFC3339, например 2026-04-16T08:00:00Z). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.
errors
array
Ошибки валидации по полям. Поле обязательно к заполнению только при статусе FAILED; при остальных статусах поле должно быть пустым. Коды только из LocationListItemValidationErrorCode.
Ошибка валидации/бизнеса поля для scope «LocationListItem». Допустимые field: ошибки модерации локации (при status=FAILED). Для бизнес-правил витрины: code=STOREFRONT_RULE_VIOLATION.
Показать свойства
field
string
required
Путь к полю. Ожидаемые: ошибки модерации локации (при status=FAILED).
code
string
required
Коды ошибок ручки (scope LocationListItem). Допустимые field: ошибки модерации локации (при status=FAILED). - REQUIRED: Поле отсутствует или пустое, но обязательно - INVALID_TYPE: Неверный JSON-тип - INVALID_FORMAT: Общий сбой формата значения - INVALID_ENUM: Значение не из допустимого enum - INVALID_ADDRESS_FORMAT: Адрес не соответствует шаблону - INVALID_LATITUDE: Широта вне диапазона - INVALID_LONGITUDE: Долгота вне диапазона - SCHEMA_MISMATCH: Поля не соответствуют location_types / типу сущности - INVALID_TIME: Не формат HH:MM - INVALID_TIME_RANGE: Некорректный диапазон времени (from >= to и т.п.) - STOREFRONT_RULE_VIOLATION: Запрос синтаксически валиден, но отклонён бизнес-правилом витрины (детали в message)
Допустимые значения
REQUIREDINVALID_TYPEINVALID_FORMATINVALID_ENUMINVALID_ADDRESS_FORMATINVALID_LATITUDEINVALID_LONGITUDESCHEMA_MISMATCHINVALID_TIMEINVALID_TIME_RANGESTOREFRONT_RULE_VIOLATION
message
string
required
Текст для клиента. Для STOREFRONT_RULE_VIOLATION — описание правила.
address_tail
string
Адрес в текстовом формате. Обязателен при delivery_type = COURIER. Формат: «196653, Россия, г. Санкт-Петербург, г. Колпино, ул. Октябрьская, д. 77/27, подъезд 1, этаж 3, кв. 12».
comment
string
Комментарий к доставке или адресу.
latitude
number
Широта.
longitude
number
Долгота.
provider_id
string
Идентификатор провайдера доставки. Значения: CDEK, RUSSIAN_POST (Russian Post), BOXBERRY, YANDEX, 5POST, DPD, HERMES, IML, TOP_DELIVERY (TOP Delivery), OZON, KSE, STRIZH, DL, PEK; также: SBL, MVIDEO.
Допустимые значения
CDEKRUSSIAN_POSTBOXBERRYYANDEX5POSTDPDHERMESIMLTOP_DELIVERYOZONKSESTRIZHDLPEKSBLMVIDEO
provider_location_id
string
Идентификатор локации у провайдера доставки.
pickup_point_type
string
Тип пункта выдачи. - PICKUP_POINT: пункт выдачи. - POSTAMAT: постамат.
Допустимые значения
PICKUP_POINTPOSTAMAT
payment_methods
array
Доступные способы оплаты на точке.
Способ оплаты на точке. - ALREADY_PAID: предоплаченные заказы. - CARD: оплата картой. - CASH: оплата наличными.
storage_period_days
integer
Число дней хранения заказа на точке.
limits
object
required
Предельные габариты и вес заказа для точки (ВГХ, см и кг).
Показать свойства
length
number
Максимальная длина заказа, см.
width
number
Максимальная ширина заказа, см.
height
number
Максимальная высота заказа, см.
weight
number
Максимальный вес заказа, кг.
instruction
string
Инструкция как добраться для отображения на витрине.
pickup_services
array
Дополнительные услуги пункта выдачи.
Дополнительная услуга ПВЗ. - FITTING: возможна примерка.
working_schedule
array
Расписание работы.
Показать свойства
day
string
required
День недели.
Допустимые значения
MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY
schedule
object
required
Расписание на день.
Показать свойства
time_start
string
Время начала, формат «00:00».
time_end
string
Время окончания, формат «00:00».
break
string
Перерыв, формат «13:00–14:00».
shipping_cutoff
string
Время, после которого отсчёт слота доставки начнётся со следующего дня. Формат «16:30». Если пустое — не применяется.
individual_schedule
array
Индивидуальное расписание на определённые даты. К примеру, праздничные дни (при отличии от working_schedule).
Показать свойства
date
string
required
Дата, формат «YYYY-MM-DD».
schedule
object
Расписание на дату.
Показать свойства
time_start
string
Время начала, формат «00:00».
time_end
string
Время окончания, формат «00:00».
break
string
Перерыв, формат «13:00–14:00».
shipping_cutoff
string
Время, после которого отсчёт слота доставки начнётся со следующего дня. Формат «16:30». Если пустое — не применяется.
is_works
boolean
required
Признак работы в дату.
is_accepts_returns
boolean
required
Признак приёма возвратов.
next_cursor
string
Курсор начала отсчёта.
total
integer
Общее количество записей.

Ошибки

400Некорректный запрос
application/json
object
error_type
string
ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string
код ошибки
message
string
сообщение
details
object
401Ошибка авторизации
application/json
object
error_type
string
ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string
код ошибки
message
string
сообщение
details
object
429Превышен лимит запросов
application/json
object
error_type
string
ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string
код ошибки
message
string
сообщение
details
object
500Внутренняя ошибка сервера
application/json
object
error_type
string
ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string
код ошибки
message
string
сообщение
details
object
POST/v1/location/list
1curl https://api.omninet.ru/v1/location/list \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "filter": {6    "location_id": [7      "string"8    ],9    "location_types": [10      "string"11    ],12    "status": [13      "string"14    ]15  },16  "cursor": "string",17  "limit": 018}'
{
  "locations": [
    {
      "location_id": "string",
      "merchant_location_id": "string",
      "location_types": [
        "string"
      ],
      "name": "string",
      "status": "string",
      "issue": {
        "code": "string",
        "message": "string",
        "changed_at": "2026-07-02T10:25:00+02:00"
      },
      "errors": [
        {
          "field": "address_tail",
          "code": "STOREFRONT_RULE_VIOLATION",
          "message": "Локация не прошла модерацию"
        }
      ],
      "address_tail": "string",
      "comment": "string",
      "latitude": 0,
      "longitude": 0,
      "provider_id": "string",
      "provider_location_id": "string",
      "pickup_point_type": "string",
      "payment_methods": [
        "string"
      ],
      "storage_period_days": 0,
      "limits": {
        "length": 0,
        "width": 0,
        "height": 0,
        "weight": 0
      },
      "instruction": "string",
      "pickup_services": [
        "string"
      ],
      "working_schedule": [
        {
          "day": "MONDAY",
          "schedule": {
            "time_start": "string",
            "time_end": "string",
            "break": "string",
            "shipping_cutoff": "string"
          }
        }
      ],
      "individual_schedule": [
        {
          "date": "string",
          "schedule": {
            "time_start": "string",
            "time_end": "string",
            "break": "string",
            "shipping_cutoff": "string"
          },
          "is_works": true
        }
      ],
      "is_accepts_returns": true
    }
  ],
  "next_cursor": "string",
  "total": 0
}

A successful response.