API Яндекс Go для бизнеса: GET /2.0/orders/list — Список заказов клиента

В ответе: items, limit, offset, total_amount.

Параметр	Где	Тип	Обяз.	Описание
limit	query	integer	нет	По умолчанию 100
offset	query	integer	нет	Сколько записей пропустить
user_id	query	string	нет	Фильтр по сотруднику
sorting_field	query	string	нет	due_date (по умолчанию) или finished_date
sorting_direction	query	integer	нет	1 — по возрастанию, -1 — по убыванию (по умолчанию)
since_datetime	query	string	нет	Начало периода YYYY-MM-DDThh:mm:ss±hh:mm
till_datetime	query	string	нет	Конец периода

Базовые URL

• Боевой: https://b2b-api.go.yandex.ru/integration

Авторизация

Тип: OAuth 2.0

OAuth-токен получают в Кабинете Корпоративного Клиента: «Профиль компании» → «Получить токен» → вход на oauth.yandex.ru. Токен действует ограниченное время, затем его нужно получить заново.

Если по токену доступно несколько кабинетов, во всех запросах передаётся заголовок X-YaTaxi-Selected-Corp-Client-Id с ID клиента из профиля компании.

Authorization: Bearer <OAuth-токен>

Нюансы

• Порядок работы: получить токен → настроить центры затрат, роли и сотрудников → routestats → orders/create → orders/progress/orders/info → при необходимости orders/cancel.
• Координаты в route и geopoint — в порядке [долгота, широта]; в vehicle.location ответа — [широта, долгота] (см. примеры документации).
• Для отмены передайте state из cancel_rules метода orders/info.
• Также есть методы департаментов и их лимитов, районов (geo_restrictions), информации о зоне (zoneinfo), промокодов, автопарка, заказов Еды, операций Заправок и командировок.
• Для заказа доставки есть отдельный API доставки (cargo API).

Сценарии с этим методом

• Выгрузить поездки за месяц

---

Если этого недостаточно — официальная документация: https://yandex.ru/dev/taxi/doc/business-api/concepts/about-docpage/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandex-go-business.md