Get a Supplier

GET/api/v1/suppliers/{supplierId}

Retrieve a specific supplier by their Kenya Revenue Authority PIN. Supplier information is derived from purchase records. Use GET {{API_PATH}}/customers/:pin to look up the supplier's Kenya Revenue Authority registration details directly.

Requires x-api-key

http://localhost:8100/api/v1/suppliers/{supplierId}

Path Parameters

Field	Type	Required	Description
supplierId	string	Required	The supplier's 11-character Kenya Revenue Authority PIN.

How to Look Up a Supplier

Use the customer PIN lookup, the Kenya Revenue Authority eTIMS customer lookup works for any taxpayer PIN, including suppliers.

Response

{
  "success": true,
  "data": {
    "taxprNm": "SUPPLIER COMPANY LTD",
    "tin": "B000000000Z",
    "bhfId": "00",
    "prvncNm": "NAIROBI"
  }
}

curl http://localhost:8100/api/v1/customers/B000000000Z \\
  -H "x-api-key: YOUR_API_KEY"