Company Verification Request Fields
Submit company data for Company Verification. Zenoo accepts three tiers of data. More data produces richer results and fewer false positives.
Tier Examples
Tier 1: Minimum
The bare minimum for a Company Verification. Returns registry check and company screening.
{
"company_name": "Acme Holdings Ltd",
"registration_number": "12345678",
"country": "GB"
}
Tier 2: Standard
Adds directors, UBOs, and address data. Triggers individual screening for each person and enables entity correlation.
{
"company_name": "Acme Holdings Ltd",
"registration_number": "12345678",
"country": "GB",
"company_type": "Private Limited Company (Ltd)",
"incorporation_date": "2015-03-15",
"industry": "Financial Services",
"address_line_1": "123 High Street",
"city": "London",
"postcode": "EC1A 1BB",
"directors": [
{
"first_name": "Jane",
"last_name": "Smith",
"date_of_birth": "1980-05-20",
"nationality": "GB",
"role": "Director"
}
],
"ubos": [
{
"first_name": "John",
"last_name": "Doe",
"date_of_birth": "1975-11-10",
"nationality": "GB",
"ownership_percentage": 75,
"role": "UBO"
}
]
}
Tier 3: Full
Maximum data for the highest accuracy. Adds financial data, SIC codes, and an external reference for idempotency.
{
"company_name": "Acme Holdings Ltd",
"registration_number": "12345678",
"country": "GB",
"company_type": "Private Limited Company (Ltd)",
"incorporation_date": "2015-03-15",
"industry": "Financial Services",
"address_line_1": "123 High Street",
"city": "London",
"postcode": "EC1A 1BB",
"annual_revenue": "5000000",
"employee_count": "42",
"sic_codes": "64110,64191",
"status": "Active",
"external_reference": "ONBOARD-2026-0042",
"directors": [
{
"first_name": "Jane",
"last_name": "Smith",
"date_of_birth": "1980-05-20",
"nationality": "GB",
"role": "Director",
"appointed_date": "2015-03-15",
"zenoo_entity_id": "ENT-DIR-001"
}
],
"ubos": [
{
"first_name": "John",
"last_name": "Doe",
"date_of_birth": "1975-11-10",
"nationality": "GB",
"ownership_percentage": 75,
"role": "UBO",
"zenoo_entity_id": "ENT-UBO-001"
}
]
}
Company Fields
The three required fields (company_name, registration_number, country) are sufficient to run a Company Verification. All other fields are optional but improve result accuracy.
| Field | Type | Required | Tier | Description |
|---|
company_name | string | Yes | Minimum | Legal name as registered with the company registry |
registration_number | string | Yes | Minimum | Official company registration number |
country | string | Yes | Minimum | Country of incorporation. ISO 3166-1 alpha-2 code (e.g., GB, US, DE) |
company_type | string | No | Standard | Legal entity type (e.g., Private Limited Company (Ltd), PLC, LLP) |
incorporation_date | string | No | Standard | Date of incorporation. ISO 8601 format: YYYY-MM-DD |
industry | string | No | Standard | Industry sector or classification |
address_line_1 | string | No | Standard | Registered address street |
city | string | No | Standard | Registered address city |
postcode | string | No | Standard | Postal code |
annual_revenue | string | No | Full | Annual revenue in base currency. Pass as a string (e.g., "5000000") |
employee_count | string | No | Full | Number of employees. Pass as a string (e.g., "42") |
sic_codes | string | No | Full | SIC codes, comma-separated (e.g., "64110,64191") |
status | string | No | Full | Current company status: Active, Dissolved, Struck Off |
external_reference | string | No | Full | Your internal reference ID. Enables idempotency and correlation |
directors[] | array | No | Standard | Known directors. See Director fields below |
ubos[] | array | No | Standard | Known beneficial owners. See UBO fields below |
Director Fields
Each object in the directors[] array accepts:
| Field | Type | Description |
|---|
first_name | string | Director’s first name |
last_name | string | Director’s last name |
date_of_birth | string | ISO 8601 date (YYYY-MM-DD). Strongly recommended for screening accuracy |
nationality | string | ISO 3166-1 alpha-2 country code |
role | string | Role within the company: Director, Secretary, Chair |
appointed_date | string | Date of appointment. ISO 8601 format |
zenoo_entity_id | string | Your entity reference for correlation across verifications |
UBO Fields
Each object in the ubos[] array accepts:
| Field | Type | Description |
|---|
first_name | string | Beneficial owner’s first name |
last_name | string | Beneficial owner’s last name |
date_of_birth | string | ISO 8601 date (YYYY-MM-DD). Strongly recommended for screening accuracy |
nationality | string | ISO 3166-1 alpha-2 country code |
ownership_percentage | number | Ownership stake as a whole number, 0-100 (e.g., 75 for 75%) |
role | string | Role: UBO, Shareholder |
zenoo_entity_id | string | Your entity reference for correlation across verifications |
- Country codes. Always use ISO 3166-1 alpha-2 codes:
GB (not UK), US, DE, FR, IE, NL, CH.
- Dates. Use ISO 8601 format:
YYYY-MM-DD. Example: 2015-03-15.
- Numeric strings.
annual_revenue and employee_count are passed as strings, not numbers. This avoids floating-point precision issues with large values.
external_reference twice, Zenoo returns the existing case tokens without creating a duplicate. Always use external references in production for idempotency.
Director and UBO screening. Including directors[] and ubos[] in your request automatically triggers individual PEP/sanctions screening for each person. If you omit these arrays, only the company entity is screened. Zenoo may also discover additional directors and UBOs from the company registry, and screen those as well.
