Get Purchase List

GET/api/v1/purchases

Fetch incoming purchase invoices that your suppliers have submitted to Kenya Revenue Authority on your behalf. Use the since parameter to retrieve only new invoices since your last poll.

Requires x-api-key

http://localhost:8100/api/v1/purchases

Query Parameters

Field	Type	Required	Description
since	string	Optional	Return only purchases submitted after this date. Format: YYYYMMDD.

Response

{
  "resultCd": "000",
  "data": {
    "saleList": [
      {
        "spplrTin": "A111111111B",
        "spplrNm": "SUPPLIER LTD",
        "spplrInvcNo": "SINV-001",
        "regTyCd": "M",
        "salesDt": "20240110",
        "totAmt": 23200,
        "totTaxblAmt": 20000,
        "totTax": 3200,
        "salesList": [
          {
            "itemNm": "Office Furniture",
            "qty": 2,
            "prc": 10000,
            "totAmt": 23200,
            "taxTyCd": "B",
            "taxblAmt": 20000,
            "taxAmt": 3200
          }
        ]
      }
    ]
  }
}

# All purchases
curl http://localhost:8100/api/v1/purchases \\
  -H "x-api-key: YOUR_API_KEY"

# Since a specific date
curl "http://localhost:8100/api/v1/purchases?since=20240101" \\
  -H "x-api-key: YOUR_API_KEY"