Track Orders POST

/v2/tracker/query-by-tracking-nos/
Request Example

Development Endpoint: https://api.int.janio.asia/api/v2/tracker/query-by-tracking-nos/

Production Endpoint: https://api.janio.asia/api/v2/tracker/query-by-tracking-nos/

{
  "get_related_updates": true,
  "flatten_data": true,
  "tracking_nos": [
    "TRACKINGNUMBER1",
    "TRACKINGNUMBER2",
    "TRACKINGNUMBER3"
  ]
}

Query Parameters

tracking_nos

* required

Array

An array of tracking numbers. Limited to 1000 tracking numbers per call.

get_related_updates

Boolean

nullable:

true

default:

false

If true, system will send the updates relating to orders with the same shipper_order_id.

flatten_data

Boolean

nullable:

true

default:

false

If true, system will send the updates as an array instead of an object with keys being the tracking numbers.

Tracking Statuses

ORDER_CREATED

PENDING_PICKUP

FAILED_PICKUP

READY_FOR_COLLECTION

IN_TRANSIT_WITHIN_ORIGIN_COUNTRY

CROSS_BORDER_TRANSIT

IN_TRANSIT_WITHIN_DESTINATION_COUNTRY

DESTINATION_COUNTRY_CUSTOMS

DELIVERY_IN_PROGRESS

DELIVERY_COMPLETED

FAILED_DELIVERY

RETURN_TO_SENDER

EXCEPTION

CANCELLED

Response Example

Success 200

{
  'TRACKINGNUMBER1': [
    {
      'tracking_no': 'TRACKINGNUMBER1',
      'status': 'DELIVERY_IN_PROGRESS',
      'updated_on': '2020-12-27T09:53:43.355455Z'
      'description': 'The parcel is on its way to the recipient. This may take several days depending on the country/region.',
      'country': null,
      'address': null,
    },
    {
      'tracking_no': 'TRACKINGNUMBER1',
      'status': 'IN_TRANSIT_WITHIN_DESTINATION_COUNTRY',
      'updated_on': '2020-12-17T04:53:43.355418Z'
      'description': 'The parcel has arrived at a warehouse and is awaiting processing.',
      'country': 'Singapore',
      'address': 'Changi Warehouse 123',
    },
  ],
  'TRACKINGNUMBER2': [
    {
      'tracking_no': 'TRACKINGNUMBER2',
      'status': 'IN_TRANSIT_WITHIN_ORIGIN_COUNTRY',
      'updated_on': '2020-12-16T23:53:43.355439Z'
      'description': 'The parcel is about to depart a warehouse for the next facility.',
      'country': 'Indonesia',
      'address': null,
    }
  ]
}

Success (Flattened) 200

[
  {
    'tracking_no': 'TRACKINGNUMBER1',
    'status': 'DELIVERY_IN_PROGRESS',
    'updated_on': '2020-12-27T09:53:43.355455Z'
    'description': 'The parcel is on its way to the recipient. This may take several days depending on the country/region.',
    'country': null,
    'address': null,
  },
  {
    'tracking_no': 'TRACKINGNUMBER1',
    'status': 'IN_TRANSIT_WITHIN_DESTINATION_COUNTRY',
    'updated_on': '2020-12-17T04:53:43.355418Z'
    'description': 'The parcel has arrived at a warehouse and is awaiting processing.',
    'country': 'Singapore',
    'address': 'Changi Warehouse 123',
  },
  {
    'tracking_no': 'TRACKINGNUMBER2',
    'status': 'IN_TRANSIT_WITHIN_ORIGIN_COUNTRY',
    'updated_on': '2020-12-16T23:53:43.355439Z'
    'description': 'The parcel is about to depart a warehouse for the next facility.',
    'country': 'Indonesia',
    'address': null,
  }
]