Перевірка статусу UA→Світ

Отримання статусу верифікації для відправлень UA→World

get

/shipments/international/status

Повертає статуси верифікації для міжнародних відправлень для напрямку UA→World («міжнародне відправлення з України у світ»). Відповіді та помилки від основної системи проксируются без змін.

Authorizations

AuthorizationstringRequired

JWT-токен авторизації зі строком дії 1 годину у заголовку

Query parameters

refs[]string[]Required

Масив референсів відправлень. Не повинен бути порожнім. Передається як повторювані параметри запиту. Приклад запиту: refs[]=38e4fe97-9484-11f0-903f-005056bd9e02

statestring · enumRequired

Фільтр стану верифікації. Доступні значення: Order, Closed, allOrders.

Possible values:

Responses

200

Список статусів верифікації

application/json

jsonrpcstringOptional

idone ofOptional

stringOptional

or

integerOptional

400

Invalid request parameters

application/json

401

Неавторизований доступ

application/json

503

Час очікування з’єднання вичерпано

application/json

get/shipments/international/status

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"
}