Pricing

A price is calculated from the pickup and dropoff coordinates, adjusted for cargo size. No address is needed, so you can show a price at checkout before the customer has entered one.

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 }],
    "cargo_size": "M"
  }'

{
  "success": true,
  "data": {
    "quote_id": "…",
    "price": 300,
    "distance": 2400,
    "duration": 600,
    "expires_at": "2026-08-11T12:05:00.000Z",
    "dropoffs": [
      { "route_id": "…", "distance": 2400, "duration": 600, "cargo_size": "M", "price": 300 }
    ]
  }
}

distance is in metres and duration in seconds.

Cargo size

The cargo surcharge applies to each dropoff.

a top-level cargo_size applies to every dropoff;
a dropoff may set its own cargo_size, which takes precedence;
the default is M.

Each dropoff’s price already includes its surcharge, and the quote’s price is the sum of the dropoffs.

Several dropoffs

routing_mode decides how the trip is routed:

sequential (default) — one chained trip through every dropoff in order;
parallel — each dropoff is priced independently from the pickup.

How long a quote lasts

Five minutes. Pass quote_id to POST /orders to hold the price.