Retaela, Powering Retail Intelligence
Get Started

Get a Specific Purchase

GET/api/v1/purchases/{purchaseId}

Retrieve a specific purchase by its supplier invoice number (spplrInvcNo) or internal invoice number (invcNo). Fetches the full purchase list via delta sync from Kenya Revenue Authority, then filters client-side.

Requires x-api-key

http://localhost:8100/api/v1/purchases/{purchaseId}

Path Parameters

FieldTypeRequiredDescription
purchaseIdstringRequiredThe supplier invoice number (spplrInvcNo) or invoice number (invcNo) to look up.

How to Look Up a Purchase

Fetch the full purchase list via GET {{API_PATH}}/purchases, then filter by invoice number.

Response

{
  "invcNo": 1,
  "spplrTin": "B000000000Z",
  "spplrNm": "SUPPLIER COMPANY LTD",
  "spplrInvcNo": "SPPLR-INV-001",
  "pchsDt": "20240115",
  "totAmt": 5000,
  "salesSttsCd": "02",
  "itemList": []
}
# Fetch all purchases and filter locally
curl http://localhost:8100/api/v1/purchases \\
  -H "x-api-key: YOUR_API_KEY"