Retaela, Powering Retail Intelligence
Get Started

Get Reverse Invoices

GET/api/v1/reverse-invoices

List all reverse invoices (returns) for this taxpayer. Kenya Revenue Authority eTIMS does not expose a listing endpoint for submitted sales. Integrate a database and persist the Kenya Revenue Authority response from POST {{API_PATH}}/sales with rcptTyCd 'R' to enable listing.

Requires x-api-key

http://localhost:8100/api/v1/reverse-invoices

Query Parameters

FieldTypeRequiredDescription
sincestringOptionalFilter from this date, yyyyMMddHHmmss. Reserved for database integration.

Response

{
  "success": true,
  "data": [],
  "note": "Reverse invoice history requires a database integration. Record responses from POST /sales (rcptTyCd: R) after each return."
}
curl http://localhost:8100/api/v1/reverse-invoices \\
  -H "x-api-key: YOUR_API_KEY"