WiseStore API Reference

Base URL: https://api.wisestore.co.ke/api

Interactive documentation is on the way. This stub is served while we finalize the auto-generated reference. To generate full interactive docs locally, install Scribe:

composer require --dev knuckleswtf/scribe
php artisan vendor:publish --tag=scribe-config
php artisan scribe:generate

Authentication

All authenticated requests require a bearer token obtained from the login endpoint:

curl -X POST https://api.wisestore.co.ke/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@demo.co.ke","password":"password"}'

The response contains a token field. Attach it to every subsequent request:

Authorization: Bearer 1|abc123...

Tenant scoping

Tenant-scoped endpoints require two additional headers:

X-Company-ID — the company/tenant the request acts on
X-Store-ID — the branch context for the operation

Super admins may act on any company. Regular users are restricted to their own.

Response envelope

Lists return { data: [...], meta: {...} }. Single resources return { data: {...} }. Validation errors use Laravel's standard shape with HTTP 422.

Endpoint reference

See the service home for the full endpoint map by domain (Sales, Inventory, Money, Reports, Platform Admin).

Rate limits

Authenticated: 120 requests / minute / user
Unauthenticated: 30 requests / minute / IP
Webhooks: unlimited (signature-verified)

Support

Email developers@wisestore.co.ke for integration support.