E-SadarakDevelopers
enazru

Partner API

Integrate cargo, payments and storefronts with Sadarak

A versioned REST API (/v1) with an OpenAPI spec as the source of truth. Phone-OTP auth is live today; partner endpoints, API keys and webhooks land in Phase 5.

Open the API referenceDownload openapi.json

What the API offers

  • Catalog

    Categories, product search in az/ru/en and vendor pages from thousands of Sadarak stalls.

  • Orders & tracking

    Create orders on behalf of customers and follow the status timeline from PLACED to DELIVERED.

  • Logistics partners

    Cargo and payment partners plug in under /v1/partner with API-key auth and scoped rate limits.

  • Webhooks

    order.delivered and batch.completed events, signed with HMAC so you can verify every delivery.

Availability

Available now

Health check and phone-OTP authentication (/v1/auth/*).

Phase 5

Partner endpoints, API key self-service, webhook configuration and delivery logs, sandbox environment.

Conventions

  • All amounts are integers in qəpik (AZN minor units); fields end in Qepik.
  • Errors are JSON with a stable code (ERR_*) and never localized text.
  • Phone numbers are E.164 (+994XXXXXXXXX). Access tokens live 15 minutes, refresh tokens 30 days.
  • Realtime updates over the Socket.IO namespace /realtime with the access token in the handshake.