Business Verification

Verify businesses (KYB) including company registration, directors, and Ultimate Beneficial Owners (UBOs). The public API supports a step-by-step flow for company data, directors, and beneficial owners.

KYB Flow

Business verification follows a multi-step flow: start verification, add directors, add UBOs, then let the system process 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

Code Examples

curl -X POST https://api.verifyhq.wejoona.com/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.wejoona.com/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 one director/officer to a business verification for identity and AML screening.

Request Body

Parameter	Type	Description
`fullName`required	string	Director full name
`position`required	string	Position in the company, e.g. CEO or Director
`dateOfBirth`	string	Date of birth (YYYY-MM-DD)
`nationality`	string	ISO country code
`idNumber`	string	National ID or passport number

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

POST/verifications/business/:id/ubos

Add one Ultimate Beneficial Owner (UBO) to the business verification.

Request Body

Parameter	Type	Description
`fullName`required	string	UBO full name
`ownershipPercentage`required	number	Ownership percentage (0-100)
`dateOfBirth`	string	Date of birth (YYYY-MM-DD)
`nationality`	string	ISO country code

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

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.wejoona.com/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