Verification ChecksBusiness & compliance

Business registration

Confirm a company is registered, and read its registry record.

Send BRS_BUSINESS in checksRequested to run this check.

Use the company registration number as subject.idNumber.

The request

POST /api/v1/reports
{
  "subject": {
    "fullName": "Example Holdings Limited",
    "idNumber": "PVT-5M198M5B",
    "email": "company@example.com",
    "phone": "+254712345678",
    "country": "KE",
    "subjectType": "BUSINESS"
  },
  "checksRequested": [
    "BRS_BUSINESS"
  ],
  "purpose": "Supplier due diligence",
  "consent": {
    "mode": "VERIFISHA_HOSTED"
  }
}

The acknowledgement

Creation is asynchronous. The report comes back as a draft; the check runs after.

201 Created
{
  "reports": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "status": "DRAFT",
      "paymentState": {
        "status": "NOT_REQUIRED",
        "amount": {
          "amount": 0.1,
          "currency": "KES"
        }
      },
      "consentState": {
        "status": "NOT_REQUIRED"
      }
    }
  ],
  "count": 1
}

The result

When the check finishes, this arrives at your webhook. COMPLETED means it ran — read riskLevel and flags to decide what it found.

On this page