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

POST /v1/location/list

POST/v1/location/list

Метод возвращает список локаций с фильтрами и пагинацией.

Тело запроса

filter

object

required

Фильтр. Если поле фильтра не передано, равно null или передан пустой массив [], фильтрация по этому полю не применяется. При одновременном указании нескольких фильтров условия объединяются по AND.

Показать свойства

location_id

array

Фильтр по идентификаторам локации.

location_types

array

Фильтр по типам локации.

WAREHOUSE: склад

PICKUP_POINT: пункт выдачи

CLICK_AND_COLLECT: пункт самовывоза (Click & Collect)

Допустимые значения

WAREHOUSEPICKUP_POINTCLICK_AND_COLLECT

status

array

Фильтр по статусам локации.

DRAFT: создан

PENDING: в обработке

ACTIVE: включена, доступна к выбору

QUARANTINE: карантин

FAILED: не прошёл модерацию

ARCHIVED: перенесён в архив

Допустимые значения

DRAFTPENDINGACTIVEQUARANTINEFAILEDARCHIVED

cursor

string

Курсор начала отсчёта.

limit

integer

required

Размер страницы. min = 1; max = 300; default = 100.

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

200A successful response.

application/json

object

locations

array

required

Отфильтрованный список локаций.

LocationListItem

Показать свойства

LocationListItem

location_id

string

required

Идентификатор локации.

merchant_location_id

string

Идентификатор локации продавца.

location_types

array

required

Типы локации. Набор определяет допустимую схему данных и валидацию полей.

CLICK_AND_COLLECT одновременно является складом и пунктом вывоза — не нужно дублировать её отдельным складом.

WAREHOUSE: склад

PICKUP_POINT: пункт выдачи

CLICK_AND_COLLECT: пункт самовывоза (Click & Collect)

Допустимые значения

WAREHOUSEPICKUP_POINTCLICK_AND_COLLECT

name

string

required

Название локации.

status

string

required

Статус локации в витрине.

DRAFT: создан

PENDING: в обработке

ACTIVE: включена, доступна к выбору

QUARANTINE: карантин

FAILED: не прошёл модерацию

ARCHIVED: перенесён в архив

Допустимые значения

DRAFTPENDINGACTIVEQUARANTINEFAILEDARCHIVED

issue

object

Ответ от витрины когда локация не прошла модерацию.

Показать свойства

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). Несоблюдение формата может привести к непредсказуемому поведению системы и проблемам с заказами.

address_tail

string

Адрес в текстовом формате. Формат: «196653, Россия, г. Санкт-Петербург, г. Колпино, ул. Октябрьская, д. 77/27, подъезд 1, этаж 3, кв. 12».

comment

string

Комментарий к доставке или адресу.

latitude

number

Широта.

longitude

number

Долгота.

provider_id

string

Идентификатор провайдера доставки.

CDEK: СДЭК

RUSSIAN_POST: Почта России

BOXBERRY: Boxberry

YANDEX: Яндекс Доставка

5POST: 5Post

DPD: DPD

HERMES: Hermes

IML: IML

TOP_DELIVERY: Top Delivery

OZON: 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: оплата наличными

Допустимые значения

ALREADY_PAIDCARDCASH

storage_period_days

integer

Число дней хранения заказа на точке.

limits

object

required

Предельные габариты и вес заказа для точки (ВГХ, см и кг).

Показать свойства

length

number

Максимальная длина заказа, см.

width

number

Максимальная ширина заказа, см.

height

number

Максимальная высота заказа, см.

weight

number

Максимальный вес заказа, кг.

instruction

string

Инструкция как добраться для отображения на витрине.

pickup_services

array

Дополнительные услуги пункта выдачи.

FITTING: возможна примерка

Допустимые значения

FITTING

working_schedule

array

Расписание работы.

LocationCreateListWorkingSchedule

Показать свойства

LocationCreateListWorkingSchedule

day

string

required

День недели.

MONDAY: понедельник

TUESDAY: вторник

WEDNESDAY: среда

THURSDAY: четверг

FRIDAY: пятница

SATURDAY: суббота

SUNDAY: воскресенье

Допустимые значения

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).

LocationCreateListIndividualSchedule

Показать свойства

LocationCreateListIndividualSchedule

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

is_works

boolean

required

Признак работы в дату.

is_accepts_returns

boolean

required

Признак приёма возвратов.

next_cursor

string

Курсор начала отсчёта.

total

integer

Общее количество записей.

Ошибки

400Некорректный запрос

application/json

object

error_type

string

Класс транспортной ошибки запроса (HTTP 4xx/5xx).

Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.

ERROR_TYPE_UNSPECIFIED: не используется
ERROR_TYPE_UNAUTHORIZED: HTTP 401
ERROR_TYPE_RATE_LIMIT: HTTP 429
ERROR_TYPE_INTERNAL: HTTP 500
ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)

Допустимые значения

ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST

code

string

Машинный код ошибки. Уточняет error_type.

message

string

Человекочитаемое сообщение об ошибке.

details

object

401Ошибка авторизации

application/json

object

error_type

string

Класс транспортной ошибки запроса (HTTP 4xx/5xx).

Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.

ERROR_TYPE_UNSPECIFIED: не используется
ERROR_TYPE_UNAUTHORIZED: HTTP 401
ERROR_TYPE_RATE_LIMIT: HTTP 429
ERROR_TYPE_INTERNAL: HTTP 500
ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)

Допустимые значения

ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST

code

string

Машинный код ошибки. Уточняет error_type.

message

string

Человекочитаемое сообщение об ошибке.

details

object

429Превышен лимит запросов

application/json

object

error_type

string

Класс транспортной ошибки запроса (HTTP 4xx/5xx).

Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.

ERROR_TYPE_UNSPECIFIED: не используется
ERROR_TYPE_UNAUTHORIZED: HTTP 401
ERROR_TYPE_RATE_LIMIT: HTTP 429
ERROR_TYPE_INTERNAL: HTTP 500
ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)

Допустимые значения

ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST

code

string

Машинный код ошибки. Уточняет error_type.

message

string

Человекочитаемое сообщение об ошибке.

details

object

500Внутренняя ошибка сервера

application/json

object

error_type

string

Класс транспортной ошибки запроса (HTTP 4xx/5xx).

Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.

ERROR_TYPE_UNSPECIFIED: не используется
ERROR_TYPE_UNAUTHORIZED: HTTP 401
ERROR_TYPE_RATE_LIMIT: HTTP 429
ERROR_TYPE_INTERNAL: HTTP 500
ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)

Допустимые значения

ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST

code

string

Машинный код ошибки. Уточняет error_type.

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"
      },
      "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.