v3.2 · REST · OpenAPI 3.1

One endpoint for every freight rate in India.

Query 62 carriers, get a normalised quote in under 300 ms. No per-carrier onboarding, no XML, no SOAP envelope you have to reverse engineer at 1am.

$ REQUEST

curl https://api.meridian.dev/v3/rates \

-H "Authorization: Bearer sk_live_9f2a..." \

-d origin=411001 -d destination=560034 \

-d weight_kg=18.5 -d mode=surface

200 OK · 214 ms

{ "quotes": [

{ "carrier": "bluedart", "amount": 412.00, "eta_days": 2 },

{ "carrier": "delhivery", "amount": 366.50, "eta_days": 3 },

{ "carrier": "ekart", "amount": 341.00, "eta_days": 4 } ],

"cheapest": "ekart", "cached": false }

// CORE RESOURCES

Four objects. That is the whole API.

Real-time quotes across 62 carriers. Idempotent, cacheable for 15 minutes, never charged for.

Book against a quote ID. Returns an AWB, a label PDF and a manifest row.

Normalised status across every carrier: 9 states, not 340 vendor strings.

Signed with HMAC-SHA256, retried for 24 hours with exponential backoff.

// OFFICIAL SDKS

Is there a sandbox?+

Yes — every key has a test mode twin (sk_test_). Sandbox returns deterministic quotes so you can assert on exact amounts in CI.

What happens when a carrier API is down?+

That carrier drops out of the quote array and appears in a `degraded` list. We never fail the whole request because one upstream is having a day.

How are you priced?+

₹1.40 per booked shipment. Rate lookups and tracking calls are free and always will be — charging for reads makes people cache badly.

Do you support scheduled pickups?+

Yes, on 41 of the 62 carriers. `carrier.capabilities` tells you which, so you never have to hardcode a list that goes stale.

Can I self-host?+

No. But every response includes the raw upstream payload under `_raw`, so you are never locked out of data we normalised away.