Developers

Osaadi Reseller API

Push orders, fetch wholesale pricing, and check order status programmatically with a simple Bearer-authenticated REST API built for approved Osaadi resellers in Pakistan.

Authentication

Generate an API key in your reseller dashboard (keys look like osk_live_…). Send it as a Bearer token on every request. Keep it secret, since it grants wholesale ordering on your account.

Authorization: Bearer osk_live_xxxxxxxxxxxxxxxx

Base URL: https://osaadi.pk/api/v1

Endpoints

GET/api/v1/pricing

Your wholesale price for every product.

curl https://osaadi.pk/api/v1/pricing \
  -H "Authorization: Bearer osk_live_…"

{
  "products": [
    { "id": "p1", "slug": "the-original-mustache-tee", "price": 1290 },
    { "id": "p2", "slug": "osaadi-enamel-mug", "price": 650 }
  ]
}

POST/api/v1/orders

Create an order. Totals are computed server-side from your wholesale pricing. productId accepts an id or slug; qty is 1–500.

curl -X POST https://osaadi.pk/api/v1/orders \
  -H "Authorization: Bearer osk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": { "name": "Ali", "email": "ali@shop.pk", "city": "Lahore" },
    "items": [
      { "productId": "the-original-mustache-tee", "qty": 10, "size": "M", "color": "Black" }
    ]
  }'

{ "order": { "id": "OS-48213", "total": 12900, "status": "placed" } }

GET/api/v1/orders/:id

Fetch one of your orders with its live status and courier tracking.

curl https://osaadi.pk/api/v1/orders/OS-48213 \
  -H "Authorization: Bearer osk_live_…"

{
  "order": {
    "id": "OS-48213", "status": "shipped",
    "courier": "TCS", "trackingNo": "…", "total": 12900
  }
}

Errors & limits

Errors return a JSON body { "error": "message" } with a 4xx status.
401: missing or invalid key, or a non-reseller account.
Quantities are capped at 500 per line item.
Be a good citizen: batch requests and cache pricing.

Not a reseller yet?

Apply for wholesale pricing + API access.

Become a reseller