Company Director

The Company Director Answer is used to submit information about the directors of a company or legal entity, which is an important component of corporate governance disclosure and beneficial ownership verification.

Fields

Base Fields

Field	Type	Required	Description
fieldTypeId	string	Yes	Must be set to "CompanyDirector" (from FieldTypeEnum)
directors	array	Yes	List of company director items

Company Director Item Fields

Field	Type	Required	Description
userDetails	object	Yes	Personal details of the director
nationalityId	string	Yes	Country identifier for the director's nationality
idVerificationDocumentNumber	string	No	Document number for the identification document
idVerificationDocumentExpiry	string	No	Expiry date of the identification document in ISO format (YYYY-MM-DD)
idCardFrontDocumentId	string	Conditional	ID of the uploaded ID card front document (required if identification type is ID card)
idCardBackDocumentId	string	Conditional	ID of the uploaded ID card back document (if applicable)
passportDocumentId	string	Conditional	ID of the uploaded passport document (required if identification type is passport)
identificationTypeId	string	Yes	Type of identification document provided (either "IdCard" or "Passport")

Director User Details Fields

Field	Type	Required	Description
firstName	string	Yes	First name of the director
middleName	string	No	Middle name of the director
lastName	string	Yes	Last name of the director
dateOfBirth	string	No	Date of birth in ISO format (YYYY-MM-DDTHH:MM:SS)
gender	string	No	Gender of the director

Example Usage

{
  "fqName": "CompanyInfo_Governance_Directors",
  "answer": {
    "fieldTypeId": "CompanyDirector",
    "directors": [
      {
        "userDetails": {
          "firstName": "John",
          "middleName": "William",
          "lastName": "Smith",
          "dateOfBirth": "1975-06-15T00:00:00",
          "gender": "Male"
        },
        "nationalityId": "GB",
        "idVerificationDocumentNumber": "PA12345678",
        "idVerificationDocumentExpiry": "2029-10-20",
        "passportDocumentId": "a640b5fd-0b98-494a-a6ec-6f7f8e323ff72",
        "identificationTypeId": "Passport"
      },
      {
        "userDetails": {
          "firstName": "Sarah",
          "lastName": "Johnson",
          "dateOfBirth": "1982-09-21T00:00:00",
          "gender": "Female",
          "tenantDetailsId": "f4e72dba-7b5c-8g7h-9i8j-12k34l56m78n"
        },
        "nationalityId": "AE",
        "idVerificationDocumentNumber": "784-1982-1234567-8",
        "idVerificationDocumentExpiry": "2028-05-15",
        "idCardFrontDocumentId": "b751c6ge-7d0b-6g0g-d0f9-31f0hef9g56d",
        "idCardBackDocumentId": "c862d7hf-8e1c-7h1h-e1g0-42g1ifg0h67e",
        "identificationTypeId": "IdCard"
      }
    ]
  }
}

Notes

• Multiple directors can be provided by adding multiple items to the directors array.
• Either passport or ID card identification documents must be provided for each director.
• The identification document type must match the provided document IDs (e.g., if identificationTypeId is "IdCard", then idCardFrontDocumentId must be provided).
• All document IDs must reference documents previously uploaded using the Document Upload API.
• Director information is often required for regulatory compliance, particularly for AML (Anti-Money Laundering) and KYC (Know Your Customer) purposes.
• Director verification is an important part of establishing the corporate governance structure and beneficial ownership of the company.
• For companies with complex directorship structures, the Multi-Level Director Answer type might be used instead.