---
title: "Track Shipment"
method: GET
path: "/v1/track"
tags: ["Tracking"]
---

# Track Shipment

`GET /v1/track`

Track a shipment.

Requires valid API key in X-API-Key header.

Use GET /v1/couriers to get the list of available courier slugs.

All requests are synchronous and blocking. For async couriers like Speed Post
and India Post, TrackRouter polls the backend internally and returns the final
result. This may take 10-30 seconds but provides a simpler developer experience.

Returns:
    - 200: Tracking result with checkpoints
    - 400: Invalid courier or tracking number
    - 401: Invalid or missing API key
    - 402: Quota exceeded
    - 404: Courier not found
    - 502/504: Backend service error

## Query parameters

- `courier` string, required — Courier slug (e.g., 'bluedart', 'delhivery')
- `tracking_number` string, required — AWB/tracking number

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/trackcourier/apis/trackcourier-io-api.md) · [All operations](https://skmtc.dev/trackcourier/apis/trackcourier-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trackcourier/trackcourier-io-api/revisions/2c7fa1f695ef/schema)