NIninjavan
Tracking API

Get events for list of parcels

Retrieve tracking events for a list of tracking numbers.

How to request access

Access to this endpoint is conditional. By default, Ninja Van doesn't grant the permission to use this endpoint to any shipper, even in the sandbox environment. To request access, take these steps:

  1. Review the Integration requirements.
  2. Send an email to developer support.
get/{countryCode}/1.0/orders/tracking-events

Request

  • Base URL
    https://api-sandbox.ninjavan.co
  • URL
    https://api-sandbox.ninjavan.co/{countryCode}/1.0/orders/tracking-events
  • Auth
    none declared. Required headers: Authorization

Path parameters

countryCode'SG' | 'MY' | 'TH' | 'ID' | 'VN' | 'PH' | 'MM' required

Country code.

Query parameters

tracking_numberstring required

The list of tracking_number to track, limited to 50 per request.

Headers

Authorizationstring required

Your Bearer token.

Response

Events retrieved successfully.

Example response

{
  "data": [
    {
      "tracking_number": "NVSG01NFD000000001",
      "is_full_history_available": true,
      "events": [
        {
          "shipper_id": 100001,
          "tracking_number": "NVSG01NFD000000001",
          "shipper_order_ref_no": "NVQA-NFD",
          "timestamp": "2021-12-15T06:22:48+0000",
          "status": "Pending Pickup",
          "is_parcel_on_rts_leg": false
        },
        {
          "shipper_id": 100001,
          "tracking_number": "NVSG01NFD000000001",
          "shipper_order_ref_no": "NVQA-NFD",
          "timestamp": "2021-12-15T06:23:20+0000",
          "status": "Arrived at Origin Hub",
          "is_parcel_on_rts_leg": false,
          "comments": "SG-BUKIT TIMAH-Zone"
        },
        {
          "shipper_id": 100001,
          "tracking_number": "NVSG01NFD000000001",
          "shipper_order_ref_no": "NVQA-NFD",
          "timestamp": "2021-12-15T06:23:40+0000",
          "status": "Delivered",
          "is_parcel_on_rts_leg": false
        },
        {
          "shipper_id": 100001,
          "tracking_number": "NVSG01NFD000000001",
          "shipper_order_ref_no": "NVQA-NFD",
          "timestamp": "2021-12-15T06:23:40+0000",
          "status": "Delivered, Received by Customer",
          "is_parcel_on_rts_leg": false
        }
      ]
    },
    {
      "tracking_number": "NVSG01NFD000000002",
      "is_full_history_available": true,
      "events": [
        {
          "shipper_id": 100002,
          "tracking_number": "NVSG01NFD000000002",
          "shipper_order_ref_no": "NVQA-NFD",
          "timestamp": "2021-12-15T06:22:48+0000",
          "status": "Pending Pickup",
          "is_parcel_on_rts_leg": false
        },
        {
          "shipper_id": 100002,
          "tracking_number": "NVSG01NFD000000002",
          "shipper_order_ref_no": "NVQA-NFD",
          "timestamp": "2021-12-15T06:23:20+0000",
          "status": "Arrived at Origin Hub",
          "is_parcel_on_rts_leg": false,
          "arrived_at_origin_hub_information": {
            "country": "Sg",
            "city": "Marsiling",
            "hub": "Express"
          }
        },
        {
          "shipper_id": 100002,
          "tracking_number": "NVSG01NFD000000002",
          "shipper_order_ref_no": "NVQA-NFD",
          "timestamp": "2021-12-15T06:23:40+0000",
          "status": "Delivered",
          "is_parcel_on_rts_leg": false
        },
        {
          "shipper_id": 100002,
          "tracking_number": "NVSG01NFD000000002",
          "shipper_order_ref_no": "NVQA-NFD",
          "timestamp": "2021-12-15T06:23:40+0000",
          "status": "Delivered, Received by Customer",
          "is_parcel_on_rts_leg": false
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.