Businesses
Company and business-name records from the Business Registration Service.
Returns the Business Registration Service record: name, status, registration date, KRA PIN, addresses and partners/directors.
Price: set by your bundle; one charge per call. "Not found" answers (result.found: false) are charged. Source failures return 502 and are refunded.
Try it: choose a scenario from the example menu under the code sample and press Test Request. Paste your test key into Authentication in the window that opens (it is remembered); test keys return sandbox sample data, free.
ApiKeyAuthorizationBearer <token>Your API key. sk_test_… keys use the sandbox (sample data, free); sk_live_… keys query the real sources and are charged.
Idempotency-Key?stringMakes retries safe: a repeat with the same key and body returns the original verification without charging again. Up to 255 characters.
length <= 255application/json- body
registrationNumber*stringBRS registration number of the company or business name.
3 <= length <= 40Verification completed; see result.
application/json- response
One verification. Returned by every verification API, by GET /v1/verifications/{id}, and in webhooks.
id*stringUnique id; use it to fetch the verification again.
api*stringThe verification API that was called, e.g. identity.national-id.
status*stringCOMPLETED includes "not found" answers; FAILED means the source failed and the charge was refunded.
"PENDING""COMPLETED""FAILED"environment*stringTEST for test keys (sandbox data), LIVE for live keys.
"LIVE""TEST"result*|The answer, specific to each API (see its examples). Always has found: false when the source holds no record.
error*|Set when status is FAILED.
cost*stringAmount charged in KES, as a decimal string. "0" for test keys and failed verifications.
latencyMs?|Time the source took to answer, in milliseconds.
createdAt*stringdate-timecompletedAt?|date-timecurl -X POST 'https://restapi.nilinde.com/v1/verifications/business.registration' \ -H 'Idempotency-Key: 6f1c2a90-order-1042' \ -H 'Content-Type: application/json' \ -d '{ "registrationNumber": "PVT-ABC123"}'{ "id": "cmhd2k7q80001s60h3x9f2a1b", "api": "business.registration", "status": "COMPLETED", "environment": "LIVE", "result": { "found": true, "business": { "registrationNumber": "PVT-ABC123", "name": "SANDBOX TRADERS LIMITED", "status": "Registered", "registered": true, "kraPin": "P000000000Z", "registrationDate": "2018-06-01", "physicalAddress": "NAIROBI", "postalAddress": "P.O. BOX 1-00100", "partners": [ { "name": "JANE WANJIKU DOE", "shares": 1000 } ] } }, "error": null, "cost": "50", "latencyMs": 412, "createdAt": "2026-10-30T09:15:02.118Z", "completedAt": "2026-10-30T09:15:02.530Z"}