Verification status of UA→World

Get Verification status of UA→World shipments

get

https://api-stage.novapost.com/v.1.0https://api.novapost.com/v.1.0

/shipments/international/status

Returns verification statuses for international shipments for the UA→World direction (“international shipment from Ukraine to World”). Responses and errors from the core system are proxied unchanged.

🔹Description of control elements:

SCHEMA

Displays the full technical structure of the request or response, including field names, data types, required fields, allowed values, and validation rules.

• Single line description A description that fits into a single line; any text that does not fit remains hidden.

• Multiline description An expanded description that displays more than one line of text.

EXAMPLE

Shows a ready-made sample JSON with correctly formatted values to demonstrate how a valid request or response should look.

Authorizations

JWT

AuthorizationstringRequired

Authorization JWT-token with a lifetime of 1 hour in header

Query parameters

refs[]string[]Required

Array of shipment references. Must not be empty. Pass as repeated query parameters. Raw query example:
refs[]=38e4fe97-9484-11f0-903f-005056bd9e02'

statestring · enumRequired

Verification state filter. Allowed values are Order Closed allOrders.

Possible values:

Responses

200

Verification status list

application/json

jsonrpcstringOptional

idone ofOptional

stringOptional

or

integerOptional

400

Invalid request parameters

application/json

401

Unauthorized

application/json

503

Connection time-out

application/json

get

/shipments/international/status

HTTPcURLJavaScriptPython

GET /v.1.0/shipments/international/status?refs[]=text&state=Order HTTP/1.1
Host: api-stage.novapost.com/
Authorization: YOUR_API_KEY
Accept: */*

{
  "jsonrpc": "2.0",
  "result": [
    {
      "Ref": "38e4fe97-9484-11f0-903f-005056bd9e02",
      "State": "NotVerified",
      "Date": "2025-09-18 14:45:31",
      "StatusOfInternationalExpressWaybill": "Відсутні скан-копії документів",
      "Note": "test comment",
      "ClosedDate": "0001-01-01 00:00:00"
    }
  ],
  "id": "1"
}