Courier Tracking API for India That Tells You What's Wrong, Not Just Where a Parcel Is
A single normalized REST JSON API across Indian courier networks — with automated stuck-shipment detection, milestone timings, and delivery attempt failure diagnostics. Transparent rupee pricing per lookup.
Priced in Rupees (~₹0.25 Per Lookup)
No USD conversion fees, no minimum annual commits, and no mandatory sales calls. Straightforward prepaid rupee pricing for Indian engineering and operations teams.
Perfect for growing stores and developer side-projects validating carrier milestones.
Includes ClearTrack Shipment Analyzer web app to spot delivery stalls across channels.
High burst capacity (20 req/sec) and priority email support for established D2C brands.
Built for Indian Logistics & Ecommerce Use Cases
Single REST integration replacing fragmented scraping scripts, courier-specific portals, and brittle webhook pipelines.
Power branded customer order lookup pages and account order histories with unified checkpoints across all carriers.
Trigger customer notification workflows on critical events like Out for Delivery and Unsuccessful Delivery Attempt to salvage orders.
Detect customer premises closed and delivery reattempts in real-time to contact buyers before orders are initiated for return.
Compare carrier promise dates against actual final delivery timestamps to dispute billing credits and measure logistics partner SLAs.
Before & After ClearTrack
Stop writing regexes for carrier HTML scrapes and custom status mappings.
Raw Carrier Feed (Illustrative Example)
10/06 09:30 NVS BAG 09281 RCV AT BGLR_HUB
10/07 14:15 DR-LCK-EXP-ATMPT UNSUCC
10/07 18:20 DISP TO SEC HUB RETClearTrack Normalized JSON (Illustrative Example)
{
"awb": "EX123456789",
"tracking_number": "EX123456789",
"carrier": "example",
"status": "out_for_delivery",
"status_text": "Out for delivery",
"is_delivered": false,
"is_rto": false,
"origin": {
"office": null,
"city": "Bengaluru",
"state": "Karnataka",
"pincode": null
},
"destination": {
"office": null,
"city": "Bengaluru",
"state": "Karnataka",
"pincode": null
},
"estimated_delivery_at": null,
"delivered_at": null,
"first_scan_at": "2026-10-06T09:30:00.000Z",
"last_location": "Bengaluru",
"last_known_location": "Bengaluru",
"last_updated_at": "2026-10-07T18:20:00.000Z",
"last_polled_at": "2026-10-07T18:20:00.000Z",
"cached": false,
"stale": false,
"shipment": {
"service_type": null,
"weight_grams": null,
"origin": {
"office": null,
"city": "Bengaluru",
"state": "Karnataka",
"pincode": null
},
"destination": {
"office": null,
"city": "Bengaluru",
"state": "Karnataka",
"pincode": null
},
"booked_at": null
},
"milestones": {
"booked_at": null,
"picked_up_at": null,
"in_transit_at": "2026-10-06T09:30:00.000Z",
"out_for_delivery_at": null,
"first_attempt_at": "2026-10-07T14:15:00.000Z",
"delivered_at": null,
"rto_initiated_at": null,
"rto_delivered_at": null
},
"delivery_attempts": {
"count": 1,
"attempts": [
{
"at": "2026-10-07T14:15:00.000Z",
"outcome": "failed",
"reason_code": "premises_closed",
"reason_text": "DR-LCK-EXP-ATMPT UNSUCC"
}
]
},
"insights": {
"transit_days_elapsed": 1.4,
"hours_since_last_scan": 1.7,
"is_stuck": false,
"is_late_vs_carrier_edd": null,
"delay_days_vs_carrier_edd": null,
"hub_count": 2,
"current_stage": "in_transit",
"requires_attention": true,
"attention_reason": "failed_attempt",
"benchmark": {
"median_transit_days_for_route": null,
"sample_size": null,
"expected_delivery_by": null
}
},
"events": [
{
"timestamp": "2026-10-07T18:20:00.000Z",
"status": "in_transit",
"status_text": "DISP TO SEC HUB RET",
"code": "dispatched",
"facility": "Bengaluru",
"location": "Bengaluru",
"description": "DISP TO SEC HUB RET"
},
{
"timestamp": "2026-10-07T14:15:00.000Z",
"status": "in_transit",
"status_text": "DR-LCK-EXP-ATMPT UNSUCC",
"code": "delivery_attempted",
"facility": "Bengaluru",
"location": "Bengaluru",
"description": "DR-LCK-EXP-ATMPT UNSUCC"
},
{
"timestamp": "2026-10-06T09:30:00.000Z",
"status": "in_transit",
"status_text": "NVS BAG 09281 RCV AT BGLR_HUB",
"code": "received",
"facility": "BGLR_HUB",
"location": "BGLR_HUB",
"description": "NVS BAG 09281 RCV AT BGLR_HUB"
}
]
}Insights Computed by ClearTrack
Every tracking lookup automatically computes shipment health metrics so your software can trigger NDR workflows and alert operations before customers escalate.
Stage Classification
Deterministic lifecycle stages: booked, in_transit, out_for_delivery, delivery_attempted, delivered, or rto_in_progress.
Stuck Parcel Detection
Automatically flags shipments with is_stuck: true when transit scans pause for over 72 consecutive hours.
Delivery Attempt Diagnostics
Parsed attempt history with normalized failure reason codes: premises_closed, consignee_unavailable, address_issue, and refused.
Operational Flags
Instant boolean requires_attention: true when a package encounters a delay, failed delivery attempt, or return-to-origin event.
Transit Metrics
Elapsed transit duration in fractional days (transit_days_elapsed) and count of distinct sort hubs traversed (hub_count).
Route Benchmarking
Coming as data growsLane-level median delivery benchmarks automatically activate once route sample sizes reach ≥ 30 delivered consignments.
Supported Indian Courier Networks
One unified schema across national postal and express parcel carriers.
Direct Courier Networks
delhiverybluedarttrackonshreemarutiindiapostspeedpostshadowfaxxpressbeesekartprofessionalAggregators
shiprocketCourier names and trademarks belong to their respective registered owners.
Transparent, Prepaid Plans
Simple fixed-period billing with no auto-debit mandates or overage surprises. Every API call counts as 1 lookup (including cache hits). All prices in INR.
- ✓ 100 lookups / 14 days
- ✓ 100 lookups daily cap
- ✓ 5 requests/sec burst limit
- ✓ 1,500 lookups / 30 days
- ✓ 300 lookups daily cap
- ✓ 5 requests/sec burst limit
- ✓ Standard email support
- ✓ 4,000 lookups / 30 days
- ✓ 800 lookups daily cap
- ✓ 10 requests/sec burst limit
- ✓ Includes Shipment Analyzer access (sign in with your ClearTrack account) Included
- ✓ Standard email support
- ✓ 12,000 lookups / 30 days
- ✓ 2,400 lookups daily cap
- ✓ 20 requests/sec burst limit
- ✓ Includes Shipment Analyzer access (sign in with your ClearTrack account) Included
- ✓ Priority email support
/v1/track/... deducts 1 lookup from your balance. Lookups do not expire until your plan's validity period ends. We never charge surprise overage fees or auto-debit your card.
How It Works
Get started with authenticated tracking in three simple steps.
Sign up to generate your free 14-day trial API key (ct_live_...) with 100 lookups instantly.
Send an HTTP GET request to /v1/track/:carrier/:awb (:tracking_number is also accepted as an alias) with your API key header.
When ready for production volume, settle your plan via a secure Razorpay payment link with zero recurring mandates.
Frequently Asked Questions
Clear answers about usage limits, data freshness, and compliance.