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.
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.
Known beneficial owners. Each person is automatically screened.
Verification initiated. Use tokens to retrieve results.
Response from async initiation endpoints (/init). Contains tokens for
retrieving results and constructing verification URLs.