openapi: 3.2.0 info: title: Shiprocket Tracking API version: v1 description: 'Shiprocket''s public REST API (v1/external) for eCommerce shipping and order management: authentication, order create/update/cancel/import, courier serviceability and AWB assignment, pickup scheduling, labels/manifests/invoices, shipment tracking, NDR actions, returns and exchanges, hyperlocal and international shipping, products, listings, channels, inventory, countries/postcodes, wallet balance, statements and discrepancies.' termsOfService: https://www.shiprocket.in/terms-conditions/ contact: name: Shiprocket API integration support email: integration@shiprocket.com url: https://apidocs.shiprocket.in/ servers: - url: https://apiv2.shiprocket.in description: Production security: - bearerAuth: [] tags: - name: Tracking description: 'Use these APIs to get the tracking details of your shipments through the AWB code or the Shipment ID. Shipment Status Codes:' paths: /v1/external/courier/track/awb/{awb_code}: get: summary: Get Tracking through AWB description: 'Get the tracking details of your shipment by entering the AWB code of the same in the endpoint URL itself. No other body parameters are required to access this API. The response is displayed in JSON format. Path:' operationId: getTrackingThroughAWB tags: - Tracking parameters: - name: awb_code in: path required: true schema: type: string responses: '200': description: Successful Call content: application/json: examples: Successful-Call: value: tracking_data: track_status: 1 shipment_status: 7 shipment_track: - id: 236612717 awb_code: '141123221084922' courier_company_id: 51 shipment_id: 236612717 order_id: 237157589 pickup_date: '2022-07-18 20:28:00' delivered_date: '2022-07-19 11:37:00' weight: '0.30' packages: 1 current_status: Delivered delivered_to: Chittoor destination: Chittoor consignee_name: '' origin: Banglore courier_agent_details: null courier_name: Xpressbees Surface edd: null pod: Available pod_status: https://s3-ap-southeast-1.amazonaws.com/kr-shipmultichannel/courier/51/pod/141123221084922.png shipment_track_activities: - date: '2022-07-19 11:37:00' status: DLVD activity: Delivered location: MADANPALLI, Madanapalli, ANDHRA PRADESH sr-status: '7' sr-status-label: DELIVERED - date: '2022-07-19 08:57:00' status: OFD activity: 'Out for Delivery Out for delivery: 383439-Nandinayani Reddy Bhaskara Sitics Logistics (356231) (383439)-PDS22200085719383439-FromMob , MobileNo:- 9963133564' location: MADANPALLI, Madanapalli, ANDHRA PRADESH sr-status: '17' sr-status-label: OUT FOR DELIVERY - date: '2022-07-19 07:33:00' status: RAD activity: 'Reached at Destination Shipment BagOut From Bag : nxbg03894488' location: MADANPALLI, Madanapalli, ANDHRA PRADESH sr-status: '38' sr-status-label: REACHED AT DESTINATION HUB - date: '2022-07-18 21:02:00' status: IT activity: InTransit Shipment added in Bag nxbg03894488 location: BLR/FC1, BANGALORE, KARNATAKA sr-status: '18' sr-status-label: IN TRANSIT - date: '2022-07-18 20:28:00' status: PKD activity: Picked Shipment InScan from Manifest location: BLR/FC1, BANGALORE, KARNATAKA sr-status: '6' sr-status-label: SHIPPED - date: '2022-07-18 13:50:00' status: PUD activity: 'PickDone ' location: RTO/CHD, BANGALORE, KARNATAKA sr-status: '42' sr-status-label: PICKED UP - date: '2022-07-18 10:04:00' status: OFP activity: 'Out for Pickup ' location: RTO/CHD, BANGALORE, KARNATAKA sr-status: '19' sr-status-label: OUT FOR PICKUP - date: '2022-07-18 09:51:00' status: DRC activity: Pending Manifest Data Received location: RTO/CHD, BANGALORE, KARNATAKA sr-status: NA sr-status-label: NA track_url: https://shiprocket.co//tracking/141123221084922 etd: '2022-07-20 19:28:00' qc_response: qc_image: '' qc_failed_reason: '' Invalid-Data: value: tracking_data: track_status: 0 error: Aahh! There is no activities found in our DB. Please have some patience it will be updated soon. schema: type: object properties: tracking_data: type: object properties: track_status: type: integer shipment_status: type: integer shipment_track: type: array items: type: object properties: id: type: integer awb_code: type: string courier_company_id: type: integer shipment_id: type: integer order_id: type: integer pickup_date: type: string delivered_date: type: string weight: type: string packages: type: integer current_status: type: string delivered_to: type: string destination: type: string consignee_name: type: string origin: type: string courier_agent_details: {} courier_name: type: string edd: {} pod: type: string pod_status: type: string shipment_track_activities: type: array items: type: object properties: date: type: string status: type: string activity: type: string location: type: string sr-status: type: string sr-status-label: type: string track_url: type: string etd: type: string qc_response: type: object properties: qc_image: type: string qc_failed_reason: type: string '404': description: Missing Fields content: application/json: examples: Missing-Fields: value: message: 404 Not Found status_code: 404 schema: type: object properties: message: type: string status_code: type: integer /v1/external/courier/track/awbs: post: summary: Get Tracking Data for Multiple AWBS description: 'Get the tracking details of multiple shipments by entering their AWB codes together as an array. The response is displayed in JSON format. Notes: Data must be passed as a string array. Maximum of 50 AWB codes is supported at a time. Parameters:' operationId: getTrackingDataForMultipleAWBS tags: - Tracking requestBody: content: application/json: schema: type: object properties: awbs: type: array items: type: string description: The AWB codes of the shipments. Must be passed as an array. required: - awbs example: awbs: - '' - '' responses: '200': description: Successful Call content: application/json: examples: Successful-Call: value: '788829354408': tracking_data: track_status: 1 shipment_status: 1 shipment_track: - id: 8067757 awb_code: '788829354408' courier_company_id: 2 shipment_id: null order_id: 16240551 pickup_date: null delivered_date: null weight: '2.5' packages: 1 current_status: AWB Assigned delivered_to: New Delhi destination: New Delhi consignee_name: Naruto origin: Jammu courier_agent_details: null shipment_track_activities: - date: '2019-08-01 02:05:05' activity: Shipment information sent to FedEx - OC location: NA track_url: https://app.shiprocket.in/tracking/awb/788829354408 '788830567028': tracking_data: track_status: 1 shipment_status: 3 shipment_track: - id: 8087109 awb_code: '788830567028' courier_company_id: 2 shipment_id: null order_id: 16255275 pickup_date: null delivered_date: null weight: '2.5' packages: 1 current_status: Pickup Generated delivered_to: New Delhi destination: New Delhi consignee_name: Naruto origin: Jammu courier_agent_details: null shipment_track_activities: - date: '2019-08-01 05:20:55' activity: Shipment information sent to FedEx - OC location: NA track_url: https://app.shiprocket.in/tracking/awb/788830567028 Invalid-or-Missing-Data: value: {} schema: type: object properties: '788829354408': type: object properties: tracking_data: type: object properties: track_status: type: integer shipment_status: type: integer shipment_track: type: array items: type: object properties: id: type: integer awb_code: type: string courier_company_id: type: integer shipment_id: {} order_id: type: integer pickup_date: {} delivered_date: {} weight: type: string packages: type: integer current_status: type: string delivered_to: type: string destination: type: string consignee_name: type: string origin: type: string courier_agent_details: {} shipment_track_activities: type: array items: type: object properties: date: type: string activity: type: string location: type: string track_url: type: string '788830567028': type: object properties: tracking_data: type: object properties: track_status: type: integer shipment_status: type: integer shipment_track: type: array items: type: object properties: id: type: integer awb_code: type: string courier_company_id: type: integer shipment_id: {} order_id: type: integer pickup_date: {} delivered_date: {} weight: type: string packages: type: integer current_status: type: string delivered_to: type: string destination: type: string consignee_name: type: string origin: type: string courier_agent_details: {} shipment_track_activities: type: array items: type: object properties: date: type: string activity: type: string location: type: string track_url: type: string '500': description: Wrong Format content: application/json: examples: Wrong-Format: value: message: Invalid argument supplied for foreach() status_code: 500 schema: type: object properties: message: type: string status_code: type: integer /v1/external/courier/track/shipment/{shipment_id}: get: summary: Get Tracking through Shipment ID description: 'Get the tracking details of your shipment by entering the shipment_id of the same in the endpoint URL. No other body parameters are required to access this API. The response is displayed in JSON format. Path:' operationId: getTrackingThroughShipmentID tags: - Tracking parameters: - name: shipment_id in: path required: true schema: type: string responses: '200': description: Successful Call content: application/json: examples: Successful-Call: value: tracking_data: track_status: 1 shipment_status: 42 shipment_track: - id: 185584215 awb_code: '1091188857722' courier_company_id: 10 shipment_id: 168347943 order_id: 168807908 pickup_date: null delivered_date: null weight: '0.10' packages: 1 current_status: PICKED UP delivered_to: Mumbai destination: Mumbai consignee_name: Musarrat origin: PALWAL courier_agent_details: null edd: '2021-12-27 23:23:18' shipment_track_activities: - date: '2021-12-23 14:23:18' status: X-PPOM activity: In Transit - Shipment picked up location: Palwal_NewColony_D (Haryana) sr-status: '42' - date: '2021-12-23 14:19:37' status: FMPUR-101 activity: Manifested - Pickup scheduled location: Palwal_NewColony_D (Haryana) sr-status: NA - date: '2021-12-23 14:19:34' status: X-UCI activity: Manifested - Consignment Manifested location: Palwal_NewColony_D (Haryana) sr-status: '5' track_url: https://shiprocket.co//tracking/1091188857722 etd: '2021-12-28 10:19:35' Invalid-Data: value: tracking_data: track_status: 0 error: Aahh! There is no activities found in our DB. Please have some patience it will be updated soon. schema: type: object properties: tracking_data: type: object properties: track_status: type: integer shipment_status: type: integer shipment_track: type: array items: type: object properties: id: type: integer awb_code: type: string courier_company_id: type: integer shipment_id: type: integer order_id: type: integer pickup_date: {} delivered_date: {} weight: type: string packages: type: integer current_status: type: string delivered_to: type: string destination: type: string consignee_name: type: string origin: type: string courier_agent_details: {} edd: type: string shipment_track_activities: type: array items: type: object properties: date: type: string status: type: string activity: type: string location: type: string sr-status: type: string track_url: type: string etd: type: string '404': description: Missing Fields content: application/json: examples: Missing-Fields: value: message: 404 Not Found status_code: 404 schema: type: object properties: message: type: string status_code: type: integer /v1/external/courier/track: get: summary: Get Tracking Data through Order ID description: 'Get the tracking details of your shipment by entering the Order ID of the same in the endpoint URL itself. If you have the same order ID in more than one channel, then use the param channel_id. The response is displayed in JSON format. Parameters: Path:' operationId: getTrackingDataThroughOrderID tags: - Tracking parameters: - name: order_id in: query schema: type: string description: The order ID/number of your store. required: true example: '123' - name: channel_id in: query schema: type: integer description: Channel ID corresponding to the store example: '12345' responses: '200': description: Get Tracking Data through Order iD content: application/json: examples: Get-Tracking-Data-through-Order-iD: value: - tracking_data: track_status: 1 shipment_status: 42 shipment_track: - id: 185584215 awb_code: '1091188857722' courier_company_id: 10 shipment_id: 168347943 order_id: 168807908 pickup_date: null delivered_date: null weight: '0.10' packages: 1 current_status: PICKED UP delivered_to: Mumbai destination: Mumbai consignee_name: Musarrat origin: PALWAL courier_agent_details: null edd: '2021-12-27 23:23:18' shipment_track_activities: - date: '2021-12-23 14:23:18' status: X-PPOM activity: In Transit - Shipment picked up location: Palwal_NewColony_D (Haryana) sr-status: '42' - date: '2021-12-23 14:19:37' status: FMPUR-101 activity: Manifested - Pickup scheduled location: Palwal_NewColony_D (Haryana) sr-status: NA - date: '2021-12-23 14:19:34' status: X-UCI activity: Manifested - Consignment Manifested location: Palwal_NewColony_D (Haryana) sr-status: '5' track_url: https://shiprocket.co//tracking/1091188857722 etd: '2021-12-28 10:19:35' schema: type: array items: type: object properties: tracking_data: type: object properties: track_status: type: integer shipment_status: type: integer shipment_track: type: array items: type: object properties: id: type: integer awb_code: type: string courier_company_id: type: integer shipment_id: type: integer order_id: type: integer pickup_date: {} delivered_date: {} weight: type: string packages: type: integer current_status: type: string delivered_to: type: string destination: type: string consignee_name: type: string origin: type: string courier_agent_details: {} edd: type: string shipment_track_activities: type: array items: type: object properties: date: type: string status: type: string activity: type: string location: type: string sr-status: type: string track_url: type: string etd: type: string components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: 'JWT obtained from POST /v1/external/auth/login using an API user email + password (Settings > API > Add New API User). The token is valid for 10 days; send it as Authorization: Bearer .' externalDocs: url: https://apidocs.shiprocket.in/ description: Shiprocket API documentation (Postman documenter) x-generated-from: type: postman-collection url: https://apidocs.shiprocket.in/api/collections/8407119/SzYW1zB2?environment=8407119-3ebd70ec-0118-4aa7-a886-4802616014f5&segregateAuth=true&versionTag=latest documenter: https://apidocs.shiprocket.in/ collection_id: f5af337c-69fc-49c7-8418-e2f6ee461674 generated: '2026-09-18' method: generated note: Faithful conversion; schemas inferred from published parameter tables and examples.