Get a List of Customers

GET/api/v1/customers

Returns customers stored in your Ushuru organisation database. Use GET /api/v1/customers/:pin for Kenya Revenue Authority PIN lookup.

Requires x-api-key

http://localhost:8100/api/v1/customers

Look Up a Customer by PIN

Use the PIN lookup endpoint to validate a customer against Kenya Revenue Authority records:

Response

{
  "success": true,
  "data": {
    "customers": [
      {
        "id": "uuid",
        "custTin": "A000000000Z",
        "custNm": "BUYER COMPANY LTD"
      }
    ]
  }
}

# Look up a specific customer by Kenya Revenue Authority PIN
curl http://localhost:8100/api/v1/customers/A000000000Z \\
  -H "x-api-key: YOUR_API_KEY"