Business Verification

Verify businesses (KYB) including company registration, directors, and Ultimate Beneficial Owners (UBOs). Covers OHADA-registered companies, RCCM registries, and business registries across 54 African countries.

KYB Flow

Business verification follows a multi-step flow: start verification → add directors → add UBOs → system processes all checks. Each step can be done independently and the verification progresses automatically.

POST/verifications/business

Start a new business verification (KYB).

Request Body

Parameter	Type	Description
`businessName`required	string	Registered business name
`registrationNumber`required	string	Company registration number (e.g. RCCM number)
`country`required	string	ISO 3166-1 alpha-2 country code of incorporation
`businessType`	enum	SOLE_PROPRIETORSHIP, PARTNERSHIP, LLC, CORPORATION, NGO
`userId`required	string	User initiating the verification
`taxId`	string	Tax identification number (NIF/IFU)

Code Examples

curl -X POST https://api.verifyhq.com/v1/verifications/business \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "businessName": "Korido Technologies SARL",
    "registrationNumber": "RCCM-ABJ-2024-B-12345",
    "country": "CI",
    "businessType": "LLC",
    "userId": "user_123"
  }'

Response

201 Createdjson

{
  "id": "biz_abc123",
  "businessName": "Korido Technologies SARL",
  "registrationNumber": "RCCM-ABJ-2024-B-12345",
  "country": "CI",
  "status": "PENDING",
  "steps": {
    "registration": "PROCESSING",
    "directors": "PENDING",
    "ubo": "PENDING",
    "amlScreening": "PENDING"
  },
  "createdAt": "2026-02-18T13:00:00Z"
}

GET/verifications/business/:id

Retrieve the status and details of a business verification.

curl https://api.verifyhq.com/v1/verifications/business/biz_abc123 \
  -H "X-API-Key: your_api_key"

Response

200 OKjson

{
  "id": "biz_abc123",
  "businessName": "Korido Technologies SARL",
  "registrationNumber": "RCCM-ABJ-2024-B-12345",
  "country": "CI",
  "status": "VERIFIED",
  "registryData": {
    "legalName": "KORIDO TECHNOLOGIES SARL",
    "dateIncorporated": "2024-03-15",
    "status": "ACTIVE",
    "registeredAddress": "Plateau, Abidjan, Côte d'Ivoire",
    "capital": "5,000,000 XOF"
  },
  "steps": {
    "registration": "VERIFIED",
    "directors": "VERIFIED",
    "ubo": "VERIFIED",
    "amlScreening": "CLEAR"
  },
  "completedAt": "2026-02-18T13:05:00Z"
}

POST/verifications/business/:id/directors

Add directors/officers to a business verification for identity and AML screening.

Request Body

Parameter	Type	Description
`directors`required	array	Array of director objects
`directors[].fullName`required	string	Director full name
`directors[].role`required	string	Role: DIRECTOR, CEO, SECRETARY, CHAIRMAN
`directors[].dateOfBirth`	string	Date of birth (YYYY-MM-DD)
`directors[].nationality`	string	ISO country code
`directors[].idNumber`	string	National ID or passport number

curl -X POST https://api.verifyhq.com/v1/verifications/business/biz_abc123/directors \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "directors": [
      {
        "fullName": "Moussa Konaté",
        "role": "CEO",
        "dateOfBirth": "1985-03-22",
        "nationality": "CI"
      }
    ]
  }'

POST/verifications/business/:id/ubo

Add Ultimate Beneficial Owners (UBOs) — individuals owning ≥25% of the business.

Request Body

Parameter	Type	Description
`ubos`required	array	Array of UBO objects
`ubos[].fullName`required	string	UBO full name
`ubos[].ownershipPercentage`required	number	Ownership percentage (0-100)
`ubos[].dateOfBirth`	string	Date of birth (YYYY-MM-DD)
`ubos[].nationality`	string	ISO country code
`ubos[].controlType`	enum	DIRECT, INDIRECT, or BOTH

curl -X POST https://api.verifyhq.com/v1/verifications/business/biz_abc123/ubo \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "ubos": [
      {
        "fullName": "Moussa Konaté",
        "ownershipPercentage": 60,
        "nationality": "CI",
        "controlType": "DIRECT"
      }
    ]
  }'

GET/verifications/business/user/:userId

List all business verifications initiated by a user.

Query Parameters

Parameter	Type	Description
`page`	number	Page number (default: 1)
`limit`	number	Items per page (default: 20, max: 100)

curl "https://api.verifyhq.com/v1/verifications/business/user/user_123?page=1" \
  -H "X-API-Key: your_api_key"

Verification Statuses

Parameter	Type	Description
`PENDING`	status	Verification created, awaiting data submission
`PROCESSING`	status	Registry lookup and AML screening in progress
`MANUAL_REVIEW`	status	Flagged for compliance team review
`VERIFIED`	status	Business verified — all checks passed
`REJECTED`	status	Verification failed (registration not found, AML flags, etc.)

Webhook Events

Parameter	Type	Description
`business.verified`	event	Business verification completed successfully
`business.rejected`	event	Business verification rejected
`business.manual_review`	event	Business verification flagged for manual review