Get a Reverse Invoice

GET/api/v1/reverse-invoices/{saleId}

Retrieve a specific reverse invoice by sale ID. Kenya Revenue Authority eTIMS does not expose a retrieve endpoint for submitted sales. Integrate a database and persist the Kenya Revenue Authority response from POST {{API_PATH}}/sales (with rcptTyCd: 'R') to enable retrieval.

Requires x-api-key

http://localhost:8100/api/v1/reverse-invoices/{saleId}

Path Parameters

Field	Type	Required	Description
saleId	string	Required	Your return invoice number (invcNo) or Kenya Revenue Authority cumulative invoice number (cisInvcNo).

Database Integration

Filter your persisted sales records by rcptTyCd === 'R' to retrieve reverse invoices separately from regular sales.

Response

{
  "success": true,
  "data": {
    "invcNo": "RET-2024-001",
    "orgInvcNo": 42,
    "rcptTyCd": "R",
    "cisInvcNo": 44,
    "salesDt": "20240116",
    "totAmt": 5000,
    "intrlData": "AbCdEfGhIjKlMnOpQrStUvWxYz...",
    "rcptSign": "XxXxXxXxXxXxXxXxXxXxXxXx..."
  }
}

curl http://localhost:8100/api/v1/reverse-invoices/RET-2024-001 \\
  -H "x-api-key: YOUR_API_KEY"