Eng
How to choose an endpoint
integration

Nova Post offers several endpoints for processing requests for creating, tracking shipments, and other API operations:

  • 1
    Primary endpoint for all directions: https://api.novapost.com/v.1.0 - This endpoint is recommended for working with all delivery directions.
  • 2
    Separate endpoint for shipments from Ukraine: https://api.novaposhta.ua/v.1.0 - This endpoint works only for shipments within Ukraine or international shipments from Ukraine to other countries.

Comparison table of Nova Post endpoints

  • Delivery Direction 

    • 1
      Ukraine → Ukraine
    • 2
      Ukraine → World
    • 3
      Between Nova Post countries of presence
    • 4
      Within Nova Post countries of presence
    • 5
      Nova Post countries of presence → Ukraine
    • 1
      Ukraine → Ukraine
    • 2
      Ukraine → World

  • Endpoint API Keys

    • 1
      https://api.novapost.com/v.1.0
    • 2
      Test environment: https://api-stage.novapost.pl/v.1.0
    • 1
      https://api.novaposhta.ua/v.1.0/

  • API Keys

    API key generation in the Business account in Ukraine under the "Settings - Security" section, direct link to the section.

Which Endpoint to Use

It is recommended to use https://api.novapost.com/v.1.0

  • 1
    It is recommended to use https://api.novapost.com/v.1.0 as the primary endpoint for all delivery directions, both international and within Ukraine.
  • 2
    https://api.novaposhta.ua/v.1.0 operates slightly faster but is only suitable for operations within Ukraine or from Ukraine to other countries. It should be used if your operations are limited to shipments within or from Ukraine.