Get officers details for a company.

GET

/companies/{company-registration-number}/officers

Officers

Retrieve details of company officers, including directors, their roles, qualifications, occupations, and related shareholdings. This endpoint is essential for corporate governance checks, compliance (KYC/AML), and understanding decision-makers within an organization.

Request

Path Params

Header Params

Responses

🟢200OK

application/json

Success|OK

Body

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.datagardener.com/companies/12559329/officers' \
--header 'x-api-key;'

Response Example

200 - Success

{
  "companyRegistrationNumber": "string",
  "directorsData": [
    {
      "directorPnr": 0,
      "fromDate": "string",
      "toDate": "string",
      "appointment": "string",
      "position": "string",
      "directorTitle": "string",
      "directorRole": "string",
      "directorQualifications": "string",
      "directorJobRole": "string",
      "directorOccupation": "string",
      "directorshipCountUpdated": {
        "active_count": 0,
        "non_active_count": 0,
        "resined_count": 0,
        "total": 0
      },
      "directorshipCount": 0,
      "detailedInformation": {
        "forename": "string",
        "middleName": "string",
        "surname": "string",
        "fullName": "string",
        "postalCode": "string",
        "country": "string",
        "birthDate": "string",
        "nationalityName": "string",
        "nationality": "string",
        "directorAge": "string"
      },
      "hasPersonalEmailPattern": true,
      "hasPersonalDecisionMaker": true,
      "hasPersonalFacebookUrl": true,
      "hasPersonalTwitterUrl": true,
      "hasPersonalLinkedinUrl": true,
      "hasPersonalGenericMail": true,
      "email": "string",
      "linkedin_url": "string",
      "email_pattern": "string"
    }
  ],
  "shareDetails": [
    {
      "shareholderPNRNumber": "string",
      "companyRegistrationNumber": "string",
      "numberOfSharesIssued": 0,
      "shareType": "string",
      "shareClasses": "string",
      "value": 0,
      "currency": "string",
      "shareholdersDetails": {
        "shareholderTitle": "string",
        "shareholderForename": "string",
        "shareholderSurname": "string",
        "shareholderAddress1": "string",
        "shareholderAddress2": "string",
        "shareholderAddress3": "string",
        "shareholderAddress4": "string",
        "shareholderAddress5": "string",
        "shareholderPostcode": "string"
      }
    }
  ]
}

Officers

Group Structures