Partner API
For business customers and resellers: connect your procurement, ERP or shop system to Shatach Investments to get our catalogue with live prices and stock, follow your orders, balances and KRA eTIMS invoices, and request quotations.
Getting a key
Keys are issued to approved business accounts. Ask us on 0711166942 or [email protected]. Each key belongs to your account, sees only your orders, and can be revoked at any time. Keep it secret: send it only from your server, never from a web page or app.
Requests
Base address https://shatach.co.ke/api/v1. Send the key in every request:
Authorization: Bearer shk_…
Answers are JSON. Prices are in Kenya shillings, whole numbers. Up to 1,000 requests an hour per key.
| Status | Meaning |
|---|---|
| 200 / 201 | Done |
| 400 | Something in the request is wrong (the error says what) |
| 401 | Missing, unknown or revoked key |
| 403 | Your account is suspended |
| 404 | No such product, or no such order on your account |
| 429 | Too many requests this hour |
Catalogue
GET /products
Our products with today's price and stock. Filters: q (search), category, inStock=true, updatedSince=2026-10-01 (only what changed: poll this), page, pageSize (up to 200).
curl -H "Authorization: Bearer shk_…" "https://shatach.co.ke/api/v1/products?category=Laptops&inStock=true"
{ "page": 1, "pageSize": 100, "total": 118, "products": [
{ "id": 1422, "name": "Dell Pro 14 PC14250, Core Ultra 7 255U, 16GB RAM, 512GB SSD, 14\"",
"brand": "Dell", "category": "Laptops", "subcategory": "Business Laptops", "condition": "new",
"partNumber": "…", "price": 196490, "regularPrice": 196490, "currency": "KES", "inStock": true,
"url": "https://shatach.co.ke/…", "image": "https://…", "updatedAt": "2026-10-27T08:00:00.000Z" } ] }GET /products/{id}
One product, with its description, all photos and full specifications.
Your orders
GET /orders
Orders on your account, newest first, with what you owe in total. open=true: only orders not yet delivered or not yet paid.
{ "account": { "company": "…", "termsDays": 30, "creditLimit": 500000, "owed": 120000 },
"orders": [ { "orderNo": "SH-…", "status": "dispatched", "total": 120000, "balance": 120000,
"dueAt": "2026-11-27T20:59:00.000Z", "lpoNo": "LPO/123", "paymentStatus": "unpaid",
"kraInvoice": { "number": "KRACU…/12", "url": "https://shatach.co.ke/i/…" }, "items": [ … ], "history": [ … ] } ] }GET /orders/{orderNo}
One of your orders. Status is one of: new, confirmed, sourcing, dispatched, delivered, cancelled. kraInvoice.url is the printable KRA eTIMS invoice; serial numbers of the units shipped are on each item.
Quotations
POST /quote-requests
Ask for a written quotation: we reply within 2 working hours. Items by our product id, or by name for things not on the site. Optional: message, needBy, town, reference (yours), contactName, email.
curl -X POST -H "Authorization: Bearer shk_…" -H "Content-Type: application/json" \
-d '{"items":[{"productId":1422,"qty":10},{"name":"24-port gigabit switch","qty":2}],"needBy":"end of November","reference":"REQ-2026-118"}' \
https://shatach.co.ke/api/v1/quote-requests
{ "id": 57, "status": "received", "message": "We reply with a written quotation within 2 working hours." }Shatach Investments · BN-6GC86AD · Terms