Order Tracking API

Fetches real-time tracking details for one or more shipments.

Method: POST Endpoint: /custom/api/v1/order-tracking

Rate limit

50 requests per 5 minutes per IP address.

Request Fields

Field	Type	Required	Description	Example
awbs[]	array	Yes	List of AWBs to track	["84161310011340"]

Bulk AWB

You can track multiple AWBs in a single request. Each request supports a maximum of 50 AWBs.

Sample Request

curl --location 'https://shazam.velocity.in/custom/api/v1/order-tracking' \
--header 'Content-Type: application/json' \
--header 'Authorization: bbqRkOXw0xWLuYj9ubnDwg' \
--data '{
  "awbs": ["PD6786164"]
}'

Success Response

{
  "result": {
    "PD6786164": {
      "tracking_data": {
        "track_status": null,
        "shipment_status": "delivered",
        "shipment_track": [
          {
            "id": "8be85889-7f3d-4d68-81aa-14ab5d40ada9",
            "awb_code": "PD6786164",
            "courier_company_id": "CARKX7WW6UNS8",
            "shipment_id": "SHIRDNEL4I8PC",
            "order_id": "ORDVRLXCBRT4E",
            "pickup_date": "2025-07-30 16:20:31",
            "delivered_date": "2025-07-30 17:39:29",
            "weight": 0.3,
            "packages": 1,
            "current_status": "delivered",
            "delivered_to": "Bengaluru",
            "destination": "Bengaluru",
            "consignee_name": "Arun nayak",
            "origin": "Bangalore",
            "courier_agent_details": null
          }
        ],
        "shipment_track_activities": [
          {
            "date": "2025-07-30 17:39:29",
            "activity": "DELIVERED",
            "location": "Bengaluru"
          },
          {
            "date": "2025-07-30 17:38:18",
            "activity": "OUT FOR DELIVERY",
            "location": "Bengaluru"
          },
          {
            "date": "2025-07-30 16:20:31",
            "activity": "PICKED UP",
            "location": "Bengaluru"
          },
          {
            "date": "2025-07-30 16:20:30",
            "activity": "OUT FOR PICKUP",
            "location": "Bengaluru"
          }
        ],
        "track_url": "https://shipfastt.in/track/PD6786164"
      }
    }
  }
}

Response Fields

Field	Description
shipment_status	Current status of the shipment
shipment_track	Array containing shipment details
shipment_track_activities	Array of tracking events in chronological order
track_url	Public tracking URL for the shipment

shipment_status vs shipment_track[].current_status

Use shipment_status as the authoritative state

Always use the top-level shipment_status field to determine the current state of a shipment. Do not rely on shipment_track[].current_status.

shipment_track is a raw log of all events received from the 3PL carrier, in the order they arrived. Carriers frequently send scan events out of order or with delays — for example, a hub ready_for_pickup scan may arrive after the shipment has already been marked as delivered. As a result, shipment_track[].current_status on the most recent array entry may reflect a stale or out-of-sequence carrier event, not the real-world current state.

shipment_status is Velocity's de-duplicated, correctly-ordered view of the shipment state and is always authoritative.

Example: A shipment is delivered at 14:00. The carrier's system then sends a delayed ready_for_pickup hub scan at 14:30. shipment_track[].current_status on the latest entry will show ready_for_pickup — but shipment_status correctly remains delivered.