Quickstart

1. Get a key

The Govza customer creates it in their dashboard, under API-ключи.

2. Verify it

curl https://api.govza.app/v1/partner/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

Coordinates only:

curl -X POST https://api.govza.app/v1/partner/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/partner/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.

5. Follow the order

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

Or configure a Webhook to receive status changes as they happen.