Skip to content

Overview

Create and track Govza deliveries from your own system.

An API key is issued by a Govza customer from their dashboard, and every request made with it acts as that customer — the orders you create are their orders, priced and billed exactly as if they had entered them by hand.

Addresses

Govza does not geocode. Every address must arrive already structured and already carrying coordinates: latitude, longitude, area, street and building are all required. The coordinates decide routing and price; the text is what the courier reads. If your system cannot produce coordinates, it cannot use this API.

apartment, entrance and floor must be whole numbers. Anything else ("12A", "корп. 3") belongs in address.instructions, which is free text shown to the courier.

Idempotency

external_order_id is your own identifier for the order and is the idempotency key. Repeating a create with an id we have already seen returns 200 with the original order rather than creating a second delivery, so a retry after a timeout is always safe.

Information

  • OpenAPI version: 3.1.0

Authorization: Bearer gvz_<key id>_<secret> — the key issued in the Govza dashboard. It is shown once, at creation.

Security scheme type: http