Nova Poshta Tracking API & MCP

Query live Nova Poshta (novaposhta) parcels in a single synchronous GET request or MCP tool call. lastscanned reads Nova Poshta's public JSON API (api.novaposhta.ua) and returns the document's current status.

Overview & Quick FactsCopy Anchor Link

Tracking Number Formats & Auto-DetectionCopy Anchor Link

Other 14-digit numbers need ?carrier=novaposhta.

Synchronous GET Request & Normalized JSON ResponseCopy Anchor Link

curl -s "https://api.lastscanned.com/v1/track/20450123456789?carrier=novaposhta" \
  -H "Authorization: Bearer $LASTSCANNED_API_KEY"

{
  "carrier": "novaposhta",
  "trackingNumber": "20450123456789",
  "status": "in_transit",
  "statusDescription": "Parcel is on its way to the recipient city",
  "service": "WarehouseWarehouse",
  "deliveredAt": null,
  "deliveredAtLocal": null,
  "signedBy": null,
  "destination": {
    "city": "Lviv",
    "state": null,
    "country": "UA"
  },
  "events": [
    {
      "timestamp": "2026-10-26T14:05:00.000Z",
      "localTime": "2026-10-26T17:05:00",
      "status": "in_transit",
      "description": "Parcel is on its way to the recipient city",
      "location": "Lviv",
      "code": "5"
    }
  ]
}

NotesCopy Anchor Link

• Without the phone number from the express invoice, Nova Poshta returns only the current status. A result therefore has a single event (the latest status), not a full scan history.
• Times are Ukrainian local time and carry a UTC timestamp.
• Status codes are Nova Poshta's own: 1 created, 5 on the way, 7/8 waiting at a branch or locker, 9/10/11 received, 101 courier on the way, 106 return created.

Related ResourcesCopy Anchor Link

• Carrier hub: All supported carriers
• Regex & check digits: Tracking number formats & auto-detection