Orders
Track Order

Track Order

This endpoint provides real-time updates and detailed tracking information for a specific order.

The list of status codes helps you understand the different stages and outcomes of order tracking.

Status codeRemarks
2Manifested
3Out for Pickup
4Pickup Exception
5In Transit
6Reached at Destination
7Out for Delivery
8Delivered
9Undelivered
10Cancelled
11RTO
12RTO Delivered
13Misroute
14Lost
15Damaged

Parameters

No parameters are required to get order details.

Example

Response

JSON
{
  "success": true,
  "awb": "234298793452", 
  "order": "23429", 
  "order_status": "INTRANSIT",
  "order_date": "2024-11-16T16:00:12.752Z",
  "logistic": "Xpressbees",
  "created_at": "2024-11-16T16:00:12.752Z",
  "destination": "Jaipur",
  "estimated_delivery_date": "2024-11-22T16:00:12.752Z",
  "delivered_date": "",
  "tracking_history": [
    {
      "label": "Manifested",
      "activity": "Order created in system",
      "gratero_status": 2,
      "status": 15,
      "location": null,
      "timestamp": "2024-11-16T16:00:12.752Z",
    },
    {
      "label": "Out for Pickup",
      "activity": "Out for Pickup",
      "gratero_status": 3,
      "status": 18,
      "location": "Lucknow, Uttar Pradesh",
      "timestamp": "2024-11-16T16:00:12.752Z",
    },
    {
      "label": "Intransit",
      "activity": "Intransit shipment added in the bag",
      "gratero_status": 3,
      "status": 18,
      "location": "Lucknow, Uttar Pradesh",
      "timestamp": "2024-11-18T00:00:00.000Z",
    },
  ],
  "track_url": "https://gratero.com/track/234298793452",
}

Code

import { Instance } from "gratero";
 
const gratero = new Instance({
  api_key: "YOUR_API_KEY",
  secret_key: "YOUR_SECRET_KEY",
  environment: 'test'
});
 
gratero.order.track({
    awb: "234298793452",
}).then(data => console.log(data))
  .catch(error => console.log(error))