Get Sales

GET/api/v1/sales

Retrieve submitted sales. The OSCU service does not maintain a local sales database, sales are submitted to Kenya Revenue Authority and Kenya Revenue Authority does not expose a retrieval endpoint. To persist sales history, integrate a database such as Vercel KV or Supabase and record each response from POST {{API_PATH}}/sales.

Requires x-api-key

http://localhost:8100/api/v1/sales

Query Parameters

Field	Type	Required	Description
since	string	Optional	Filter from this date, yyyyMMddHHmmss format. Reserved for future database integration.
until	string	Optional	Filter to this date, yyyyMMddHHmmss format. Reserved for future database integration.

Database Integration Pattern

Field	Type	Required	Description
intrlData	string	Required	Kenya Revenue Authority internal data, must appear on printed receipts.
rcptSign	string	Required	Receipt signature, must appear on printed receipts.
cisInvcNo	number	Required	Kenya Revenue Authority-assigned cumulative invoice number.
sdcDateTime	string	Required	SDC timestamp from Kenya Revenue Authority.

Response

{
  "success": true,
  "data": [],
  "note": "Integrate a database to persist sales history. Record the response from POST /sales after each successful submission."
}

curl http://localhost:8100/api/v1/sales \\
  -H "x-api-key: YOUR_API_KEY"