Tajir Point/Docs
Get API key

Tajir Point API

A REST API over your shop: products, stock, sales, khata, and payments. Predictable resource URLs, JSON in and out, cursor pagination, idempotent writes, and signed webhooks so you can react to events instead of polling for them.

Base URLhttps://api.tajirpoint.com/api/v1

Get your API key

Authenticate, then send a token and a shop id on every call.

Products

The catalog: products, variants, SKUs and barcodes.

Sales

Create an invoice. Stock, tax and khata settle in one transaction.

Webhooks

Get told when a sale, payment or low-stock event happens.

Your first request

List the products in a shop. Swap in your token and shop id:

cURL
curl https://api.tajirpoint.com/api/v1/catalog/products/ \
  -H "Authorization: Bearer $TAJIR_TOKEN" \
  -H "X-Shop-Id: 8f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f"

Request headers

Authorization

Every request

Bearer <access token>. See Get your API key.

X-Shop-Id

Every request

The shop you are acting on. Every response is scoped to it — the same credentials serve a merchant with one branch or fifty.

Content-Type

Writes

application/json on POST, PUT and PATCH.

Idempotency-Key

Sales & payments

A unique string per logical operation, so a retry cannot double-charge. See Idempotency.

Conventions

  • Money is a decimal string — "2450.00", never a float. Parse it with a decimal type; binary floating point will cost your customer money.
  • The server is the source of truth for totals — send line items, not a grand total. Tax, discounts and rounding are recomputed server-side and the result is what gets booked.
  • Stock is never written directly — it moves. A sale, a return, a purchase, an adjustment or a transfer each produces a stock movement you can audit.
  • Timestamps are UTC ISO-8601 — 2026-07-11T09:14:22Z.