Список заказов
Заказы магазина, по умолчанию новые сверху. Страницы листаются курсором: передайте page.nextCursor в параметр cursor. Для синхронизации запрашивайте order=updatedAt:asc с filter[updatedAt][from]. Суммы в копейках. Право: orders:read.
Авторизация
bearerApiKey Ключ API в заголовке Authorization: Bearer rsk_live_…. Ключ создаёт владелец магазина: Настройки → Интеграции → API.
Где: header
Параметры запроса
Системный код статуса заказа, например new.
Системный код статуса оплаты, например paid.
ID заказа во внешней системе.
Созданы не раньше, ISO 8601 включительно.
date-timeСозданы не позже, ISO 8601 включительно.
date-timeИзменены не раньше, ISO 8601 включительно.
date-timeИзменены не позже, ISO 8601 включительно.
date-timeСортировка. По умолчанию createdAt:desc. Для синхронизации берите updatedAt:asc.
Value in
- "createdAt:desc"
- "createdAt:asc"
- "updatedAt:desc"
- "updatedAt:asc"
Что вложить в ответ. Сейчас доступно только items, позиции заказа.
Value in
- "items"
Курсор из page.nextCursor предыдущего ответа. Работает только с той же сортировкой.
Размер страницы от 1 до 100. По умолчанию 50.
Ответ
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/orders"{ "data": [ { "id": "3f0e6c5a-2b7d-4e21-9a0f-6d1c8b4e7a52", "externalId": "A-1001", "createdAt": "2026-09-12T09:41:07.000Z", "updatedAt": "2026-09-12T14:03:55.000Z", "status": { "code": "new", "name": "Новый" }, "paymentStatus": { "code": "paid", "name": "Оплачен", "isPaid": true }, "totalAmount": 327000, "discountTotal": 15000, "promoCode": "OSEN10", "currency": "RUB", "customer": { "name": "Анна Смирнова", "phone": "+79161234567", "email": "anna@example.ru" }, "delivery": { "type": "СДЭК до пункта выдачи", "cost": 35000, "discount": 0, "address": "Москва, ул. Лесная, 5, кв. 12", "city": "Москва", "region": "Москва", "street": "ул. Лесная", "house": "5", "flat": "12", "postalCode": "125047" }, "source": "api", "notes": "Позвонить за час до доставки", "items": [ { "id": "b91d2f6e-0c4a-4f8e-8d3b-27a5e1c9f604", "productId": "dcd53ddb-8104-4e48-8cc0-5df1c5a0d1e2", "externalProductId": "MS-00124", "name": "Свеча ароматическая «Хвоя», 200 г", "sku": "CNDL-200-PINE", "quantity": 2, "unitPrice": 120000, "discount": 12000, "lineTotal": 228000 }, { "id": "5e8a1b3c-7d2f-4a6e-9c0b-81f4d2e6a9c7", "productId": "a4c7e2b9-3f1d-4c8a-b6e0-9d2f5a1c7e38", "externalProductId": "MS-00311", "name": "Подставка из бетона", "sku": "HLDR-CONC", "quantity": 1, "unitPrice": 67000, "discount": 3000, "lineTotal": 64000 } ] } ], "page": { "nextCursor": "eyJjIjoiMjAyNi0wOS0xMlQwOTo0MTowNy4wMDBaIiwiaSI6IjNmMGU2YzVhIn0", "hasMore": true }}