# TrackCourier.io API

Track shipments from 25+ Indian and international couriers.

## Quick Start

Base URL: https://api.trackcourier.io/v1
Auth: X-API-Key header (get key at https://api.trackcourier.io/dashboard)

## Endpoints

### Track Shipment
GET /v1/track?courier={slug}&tracking_number={awb}

Response:
{
  "success": true,
  "data": {
    "tracking_number": "...",
    "courier": "...",
    "status": "in_transit|delivered|pending|out_for_delivery|exception",
    "origin_city": "...",
    "destination_city": "...",
    "checkpoints": [
      {"timestamp": "ISO8601", "location": "...", "status": "..."}
    ]
  },
  "usage": {"used": 42, "quota": 100, "remaining": 58}
}

### List Couriers
GET /v1/couriers
Returns: {"success": true, "data": {"couriers": [{"slug": "...", "name": "..."}], "count": N}}

### Get Courier
GET /v1/couriers/{slug}
Returns: {"success": true, "data": {"slug": "...", "name": "..."}}

## Top Couriers (use these slugs)
  - delhivery
  - bluedart
  - dtdc
  - ekart
  - xpressbees
  - speedpost
  - ecomexpress
  - shadowfax
  - indiapost
  - dhl

## Error Codes
- 401: Invalid API key
- 402: Quota exceeded
- 404: Courier not found
- 502/504: Backend timeout (retry)

## Full Reference
See /llm-full.txt for complete courier list and schemas.