Доступность

POST /availability отвечает, может ли Govza взять доставку с точки забора прямо сейчас. Вызывайте метод при оформлении заказа, чтобы решить, предлагать ли доставку Govza. Ничего не создаётся и не резервируется.

curl -X POST https://api.govza.app/v1/delivery/availability \
  -H "Authorization: Bearer $GOVZA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup":   { "latitude": 43.342439, "longitude": 45.693597 },
    "dropoffs": [{ "latitude": 43.320872, "longitude": 45.691756 }]
  }'

{
  "success": true,
  "data": {
    "available": true,
    "pickup": { "in_service_area": true },
    "dropoffs": [{ "in_service_area": true }],
    "couriers": { "status": "available", "pickup_eta": 6 },
    "reasons": [],
    "checked_at": "2026-10-05T12:00:00.000Z"
  }
}

Нужны только координаты. dropoffs указывать необязательно.

Зона обслуживания

in_service_area возвращается для точки забора и для каждой точки доставки в порядке запроса. Заказ принимается, если хотя бы одна его точка входит в зону обслуживания, поэтому заказ не будет отклонён, если одна из точек доставки окажется за её пределами.

Курьеры

couriers.status описывает свободных курьеров рядом с точкой забора:

Статус	Значение
`available`	Свободных курьеров рядом больше, чем заказов, которые уже их ждут.
`limited`	Свободные курьеры есть, но ждущие заказы могут занять их раньше. Ожидание будет дольше.
`unavailable`	Рядом с точкой забора нет свободных курьеров.

pickup_eta — оценка того, сколько минут курьеру добираться до точки забора, если создать заказ сейчас: время в пути ближайшего свободного курьера плюс обычное время на принятие заказа. Если статус unavailable, значение равно null.

Итоговый ответ

available равно true, если заказ будет принят и свободный курьер есть, — в том числе при статусе limited. Если false, причины перечислены в reasons:

outside_service_area — ни одна точка не входит в зону обслуживания, создание заказа будет отклонено;
no_couriers_nearby — рядом с точкой забора сейчас нет свободных курьеров.