curl --request POST \
--url https://instance.prod.onboardapp.io/api/gateway/execute/{project_hash}/init \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"company_name": "Acme Holdings Ltd",
"registration_number": "12345678",
"country": "GB",
"company_type": "<string>",
"incorporation_date": "2023-12-25",
"industry": "<string>",
"address_line_1": "<string>",
"city": "<string>",
"postcode": "<string>",
"annual_revenue": "<string>",
"employee_count": "<string>",
"sic_codes": "<string>",
"status": "<string>",
"external_reference": "<string>",
"directors": [
{
"first_name": "<string>",
"last_name": "<string>",
"date_of_birth": "2023-12-25",
"nationality": "<string>",
"role": "<string>",
"appointed_date": "2023-12-25",
"zenoo_entity_id": "<string>"
}
],
"ubos": [
{
"first_name": "<string>",
"last_name": "<string>",
"date_of_birth": "2023-12-25",
"nationality": "<string>",
"ownership_percentage": 123,
"role": "<string>",
"zenoo_entity_id": "<string>"
}
]
}
'{
"tokens": {
"pull": "<string>",
"start": "<string>"
}
}Initiate asynchronous company verification. Returns tokens immediately without
waiting for checks to complete. Use the pull token to retrieve results via
GET /api/gateway/sharable-payload/{pull}, or configure a webhook for delivery.
curl --request POST \
--url https://instance.prod.onboardapp.io/api/gateway/execute/{project_hash}/init \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"company_name": "Acme Holdings Ltd",
"registration_number": "12345678",
"country": "GB",
"company_type": "<string>",
"incorporation_date": "2023-12-25",
"industry": "<string>",
"address_line_1": "<string>",
"city": "<string>",
"postcode": "<string>",
"annual_revenue": "<string>",
"employee_count": "<string>",
"sic_codes": "<string>",
"status": "<string>",
"external_reference": "<string>",
"directors": [
{
"first_name": "<string>",
"last_name": "<string>",
"date_of_birth": "2023-12-25",
"nationality": "<string>",
"role": "<string>",
"appointed_date": "2023-12-25",
"zenoo_entity_id": "<string>"
}
],
"ubos": [
{
"first_name": "<string>",
"last_name": "<string>",
"date_of_birth": "2023-12-25",
"nationality": "<string>",
"ownership_percentage": 123,
"role": "<string>",
"zenoo_entity_id": "<string>"
}
]
}
'{
"tokens": {
"pull": "<string>",
"start": "<string>"
}
}Project-scoped API key for server-to-server authentication. Obtain keys from the Zenoo dashboard under Project Settings > API Keys. Staging and production environments use separate keys.
Project-scoped API key.
Unique key for idempotent request handling.
Project identifier from Zenoo Studio.
Request body for Company Verification. Zenoo accepts three tiers of data — more data produces richer results and fewer false positives.
| Tier | Fields | Result Quality |
|---|---|---|
| Minimum | company_name, registration_number, country | Registry lookup + company screening |
| Standard | + directors[], ubos[], address | Individual screening for each person |
| Full | + external_reference, annual_revenue, sic_codes | Idempotency, enriched risk scoring |
Legal name as registered with the company registry.
"Acme Holdings Ltd"
Official company registration number.
"12345678"
Country of incorporation. ISO 3166-1 alpha-2 code.
"GB"
Legal entity type (e.g., Private Limited Company (Ltd), PLC, LLP).
Date of incorporation. ISO 8601 format (YYYY-MM-DD).
Industry sector or classification.
Registered address street.
Registered address city.
Postal code.
Annual revenue in base currency. Pass as a string.
Number of employees. Pass as a string.
SIC codes, comma-separated (e.g., "64110,64191").
Current company status: Active, Dissolved, Struck Off.
Your internal reference ID. Enables idempotency — submitting the same external_reference returns the existing result without creating a duplicate.
255Known directors. Each person is automatically screened for PEP/sanctions.
Show child attributes
Known beneficial owners. Each person is automatically screened.
Show child attributes
Verification initiated. Use tokens to retrieve results.
Response from async initiation endpoints (/init). Contains tokens for
retrieving results and constructing verification URLs.
Show child attributes