> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zenoo.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Company Verification Request Fields
> Submit company data for Company Verification with three tiers of input fields.
# 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.
```json theme={null}
{
"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.
```json theme={null}
{
"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.
```json theme={null}
{
"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 |
## Formatting Notes
* **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 references.** If you submit the same `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.