Get a Customer

GET/api/v1/customers/{pin}

Look up a customer by their Kenya Revenue Authority PIN. Validates the PIN against Kenya Revenue Authority eTIMS and returns the taxpayer's registered details. Use this to verify a customer's identity before issuing a B2B invoice.

Requires x-api-key

http://localhost:8100/api/v1/customers/{pin}

Path Parameters

Field	Type	Required	Description
pin	string	Required	11-character Kenya Revenue Authority taxpayer PIN (e.g. A000000000Z).

Response

{
  "success": true,
  "data": {
    "taxprNm": "BUYER COMPANY LTD",
    "tin": "A000000000Z",
    "bhfId": "00",
    "prvncNm": "NAIROBI",
    "dstrtNm": "WESTLANDS",
    "sctrNm": "PARKLANDS",
    "locDesc": "1st Floor, Landmark Plaza",
    "telNo": "+254700000000",
    "email": "accounts@buyerco.ke",
    "useYn": "Y"
  }
}

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