Look Up a Customer PIN

GET/api/v1/customers/:pin

Look up a buyer's registered business name and branch details using their 11-character Kenya Revenue Authority PIN. Use this to auto-fill buyer details on B2B invoices.

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 PIN of the buyer (e.g. A000000000Z)

Response

{
  "resultCd": "000",
  "resultMsg": "Success",
  "data": {
    "custTin": "A000000000Z",
    "custNm": "BUYER COMPANY LTD",
    "adrs": "456 Kenyatta Avenue, Nairobi",
    "email": "accounts@buyer.co.ke",
    "msisdn": "0700000000"
  }
}

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