ENG

General information

This section contains API methods for integration with services within Ukraine.

The corresponding API documentation is available only in Ukrainian, as this functionality is intended exclusively for domestic shipments. If you are looking for a universal solution for shipments both within Ukraine and abroad, please visit the API Docs Int. section.

Аuthorization

To start working with the functionality, you need to generate an API key and include it in your requests.

For more details, visit the Api Key Generation page.

Endpoints

JSON: https://api.novaposhta.ua/v2.0/json/ XML: https://api.novaposhta.ua/v2.0/xml/

Request format

Data exchange is performed via HTTPS using the POST or GET method, sent to the appropriate endpoint depending on the request type (XML or JSON).

The format in the URL path must be specified in lowercase (e.g, https://api.novaposhta.ua/v2.0/json/).

Response format

The API always returns an HTTP 200 OK response status code, even when logical or validation errors occur within the payload.