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

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.

Getting Started

Use-Case Guides

Platform Concepts

Domain Concepts

Data Model

Company Verification Request Fields

Company Verification Request Fields

Tier Examples

Tier 1: Minimum

Tier 2: Standard

Tier 3: Full

Company Fields

Director Fields

UBO Fields

Formatting Notes

​Company Verification Request Fields

​Tier Examples

​Tier 1: Minimum

​Tier 2: Standard

​Tier 3: Full

​Company Fields

​Director Fields

​UBO Fields

​Formatting Notes

Company Verification Request Fields

Tier Examples

Tier 1: Minimum

Tier 2: Standard

Tier 3: Full

Company Fields

Director Fields

UBO Fields

Formatting Notes