Відстеження посилок одним запитом

Понад 40 поштових служб і кур'єрів України, Польщі, Іспанії та світу. Служба визначається за номером автоматично — обирати нічого не треба. Історія подій накопичується й не губиться, навіть якщо перевізник перестав віддавати старі статуси.

Почати Подивитись у роботі

Перший запит

Ключ передається заголовком X-Api-Key. Без ключа теж працює — зі спільним лімітом на IP.

curl "https://api.example.com/api/v1/track?number=CP302749188PL&lang=uk" \
  -H "X-Api-Key: trk_ваш_ключ"

{
  "number": "CP302749188PL",
  "stage": "in_transit",
  "stageLabel": "В дорозі",
  "daysInTransit": 11,
  "carriers": ["poczta-polska", "ukrposhta"],
  "fields": { "origin": "Polska", "destination": "Ukraina", "weight": "2.16" },
  "events": [
    { "date": "2026-08-27T15:27:00.000Z",
      "status": "Przyjęta w kraju przeznaczenia",
      "statusLabel": "Прибуло до країни призначення",
      "stage": "in_transit",
      "location": "Warszawa",
      "carrierName": "Poczta Polska" }
  ]
}

Методи

`GET /api/v1/track`

Головний метод. Параметри: number, lang, service (перевірити конкретну службу першою), index, phone, email для служб із підтвердженням, refresh=1 — оминути кеш.

`GET /api/v1/detect`

Які служби підходять під номер і чи потрібні їм додаткові дані — без самого запиту до перевізників.

`GET /api/v1/services`

Перелік доступних служб із країнами й сайтами. Приймає lang.

`GET /api/v1/usage`

Скільки запитів і унікальних номерів витрачено за поточний період вашим ключем.

Що всередині

Служба визначається сама

Номер зіставляється з шаблонами всіх служб; кандидати опитуються паралельно. Якщо з даних видно країну отримання, додатково питається її національна пошта — так міжнародний номер бачить і місцевий відрізок шляху.

Пов'язані номери

Коли перевізник віддає номер у службі-партнері, він перевіряється теж, а події зливаються в одну стрічку з позначкою, за яким номером їх знайдено.

Статуси однією мовою

Понад 2400 формулювань зведені до канонічних кодів і стадій (in_transit, customs, delivered…) з підписами українською, іспанською, польською, англійською та російською.

Кеш і історія

Перші хвилини після перевірки відповідь віддається з бази, далі служби опитуються знову. Збережені події ніколи не зникають — нові доклеюються до них.

Приватність

Телефон, email і поштовий індекс, які вимагають окремі служби, передаються лише для цього запиту й не зберігаються.

Ліміти й захист

Ключ можна обмежити доменом, IP, переліком служб і квотою на добу чи місяць. Запити без ключа обмежені на IP, за потреби вмикається капча.

Доступні служби

Перелік оновлюється автоматично.