🚨 Announcement

A new version of the API is available. Please review the changelog for details.

Skip to content
Kaspi delivery networkBuilt for partners

A single API to move every order in Kazakhstan

Hand off fulfillment to Kaspi, get transparent pricing at checkout, and keep customers in the loop with live tracking and reliable webhooks.

Same-day readyCourier, pickup point, lockerReplay-safe webhooks
API uptime
99.95%
Monitored 24/7
Order → pickup
4 mins
Optimized dispatch
Avg delivery SLA*
12h
Same-city routes

*Peak-aware routing with live courier capacity.

Designed for modern commerce teams

Everything you need to quote, create, track, and notify — all via API.

Nationwide coverage

Courier, locker, and pickup points across Kazakhstan with smart handoff to the closest node.

Transparent pricing

Quotes per city and weight band so you can show costs at checkout without manual lookups.

Status you can trust

Webhooks for created, accepted, picked up, out for delivery, delivered, and cancelled events.

Developer-grade reliability

Idempotent writes, replay-safe webhooks, and a sandbox that mirrors production behavior.

How it works

Four simple steps to move your first parcel.

Step 1

Create your API key

Generate a sandbox key in the partner console. Add it as x-api-key on every request.

Step 2

Create the delivery

Send POST /v1/deliveries with pickup, drop-off, and parcel meta. Track via deliveryId.

Step 3

Subscribe to webhooks

Receive milestones with signature headers. Confirm with 2xx to stop retries.

Step 4

Go live

Swap the base URL to https://api.kaspi.kz/delivery, rotate keys, and keep idempotency keys consistent.

Developer kit

Prebuilt resources to move fast and avoid surprises.

OpenAPI explorer

Interactive reference with a live playground. Download the YAML to import into your gateway.

Open the explorer

Code samples

Copy-paste snippets for curl, Node.js, and Python to create deliveries and validate signatures.

See examples

Guided setup

Follow the checklist, authentication guide, and webhook playbook to reach production safely.

Ready to ship your first delivery?Spin up in the sandbox, then swap to production when you are confident in payloads and webhooks.