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

https://staging-ushuru-api.piviotech.com/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 https://staging-ushuru-api.piviotech.com/api/v1/purchases \\
  -H "x-api-key: YOUR_API_KEY"

# Since a specific date
curl "https://staging-ushuru-api.piviotech.com/api/v1/purchases?since=20240101" \\
  -H "x-api-key: YOUR_API_KEY"