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

POST /v1/location/list

POST/v1/location/list

Тело запроса

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

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

200A successful response.
application/json
object
locations
array
Элементы списка. Локации с недоступными или несуществующими location_id в ответ не возвращаются.
LocationListItem
Показать свойства
LocationListItem
location_id
string
Идентификатор локации.
merchant_location_id
string
Идентификатор локации продавца (опционально).
location_types
array
Типы локации; элементы — WAREHOUSE (склад), PICKUP_POINT (пункт выдачи) или CLICK_AND_COLLECT (пункт самовывоза). Набор определяет допустимую схему данных и валидацию полей локации.
Тип локации в массиве location_types. - WAREHOUSE: склад. - PICKUP_POINT: пункт выдачи. - CLICK_AND_COLLECT: пункт самовывоза (Click & Collect).
name
string
Название локации.
status
string
Статус локации в витрине.
Допустимые значения
DRAFTPENDINGACTIVEFAILEDARCHIVED
issue
object
DEPRECATED. Поле устарело. Проблема по локации; пустой объект или не передаётся при статусах DRAFT и ACTIVE.
Показать свойства
code
string
Код проблемы.
message
string
Детальное описание проблемы.
changed_at
string
Момент изменения (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
Идентификатор провайдера доставки (опционально).
Допустимые значения
CDEKBOXBERRY5POSTRUSSIAN_POSTYANDEXSBLMVIDEO
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
Предельные габариты и вес заказа для точки (ВГХ, см и кг).
Показать свойства
length
number
Максимальная длина заказа, см.
width
number
Максимальная ширина заказа, см.
height
number
Максимальная высота заказа, см.
weight
number
Максимальный вес заказа, кг.
instruction
string
Инструкция как добраться для отображения на витрине (опционально).
pickup_services
array
Дополнительные услуги пункта выдачи (опционально).
Дополнительная услуга ПВЗ. - FITTING: возможна примерка.
working_schedule
array
Расписание работы.
LocationWorkingSchedule
Показать свойства
LocationWorkingSchedule
day
string
День недели.
Допустимые значения
MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY
schedule
object
Расписание на день.
Показать свойства
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).
LocationIndividualSchedule
Показать свойства
LocationIndividualSchedule
date
string
Дата, формат «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
Признак работы в дату.
is_accepts_returns
boolean
Признак приёма возвратов.
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
defaultОшибка (неожиданная или прочие)
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    "status": [7      "string"8    ],9    "location_id": [10      "string"11    ],12    "location_types": [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.