Quickstart

1. Get a key

   A key is created in the Govza dashboard under API-ключи → Создать ключ. It is shown once — store it straight away.

2. Verify it

   curl https://api.govza.app/v1/delivery/ping \
     -H "Authorization: Bearer $GOVZA_KEY"

   The response names the account the key acts as:

   {
     "success": true,
     "data": {
       "ok": true,
       "account": { "id": "…", "email": null },
       "scopes": ["orders:write"],
       "rate_limit_per_minute": 120
     }
   }

   A 401 means the key is wrong, revoked, or its account can no longer create orders.

3. Price the trip

   curl -X POST https://api.govza.app/v1/delivery/quotes \
     -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 }]
     }'

4. Create the delivery

   Creating an order requires full addresses and contacts.

   curl -X POST https://api.govza.app/v1/delivery/orders \
     -H "Authorization: Bearer $GOVZA_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "external_order_id": "SHOP-10432",
       "quote_id": "<quote_id from step 3>",
       "payment_type": "cash",
       "payment_amount": 1500,
       "comment": "Call 10 minutes ahead",
       "pickup": {
         "address": {
           "latitude": 43.342439, "longitude": 45.693597,
           "area": "Грозный", "street": "А. А. Айдамирова", "building": "123"
         },
         "contact": { "value": "+79280003396", "name": "Adam" }
       },
       "dropoffs": [{
         "address": {
           "latitude": 43.320872, "longitude": 45.691756,
           "area": "Грозный", "street": "С. Ш. Лорсанова", "building": "12",
           "apartment": 4, "entrance": 2, "floor": 3
         },
         "contact": { "value": "+79280003396", "name": "Milana" }
       }]
     }'

   The response carries the Govza order code, the final price, and a tracking URL you can forward to the recipient. Keep it: reading the order later will not create a new one.

5. Follow the order

   curl https://api.govza.app/v1/delivery/orders/SHOP-10432 \
     -H "Authorization: Bearer $GOVZA_KEY"

   Or configure a webhook to receive status changes as they happen, without polling.