---
title: "Fetch company data"
method: GET
path: "/v1/company-data/fetch/{search_ref}"
tags: ["Company data"]
---

# Fetch company data

`GET /v1/company-data/fetch/{search_ref}`

Use a `search_ref` from [Search companies](./company-data-search) result to fetch company data.

---

#### See also  
Learn more about [Company data](./company-data-guide)

## Path parameters

- `search_ref` string, required

## Response `200`

Returns Company data

**ℹ️ Click to see full payload**

- CompanyData
  - `name` string, required
  - `commercial_name` string, nullable, required
  - `registration_number` string, required
  - `country` string, alpha-2, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
  - `status` 'live' | 'closed' | 'not_reported', required
  - `registration_date` string, date, nullable, required — Date in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)(`yyyy-MM-dd` eg `2023-01-31`)
  - `legal_form` string, nullable, required
  - `entity_legal_form` string, nullable, required — [ISO 20275](https://www.gleif.org/en/about-lei/iso-20275-entity-legal-forms-code-list) code (eg: `6CHY`)
  - `entity_legal_form_label` string, nullable, required — Label in the origin country language of the [ISO 20275](https://www.gleif.org/en/about-lei/iso-20275-entity-legal-forms-code-list) code. May contains multiple labels separated with a comma `,` when the code is assigned to multiple label in different languages.
  - `address` Address, required
    - `street_address` string, nullable, required
    - `street_address_2` string, nullable, required
    - `postal_code` string, nullable, required
    - `city` string, nullable, required
    - `state` string, nullable, required
    - `region` string, nullable, required
    - `country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
  - `share_capital` string, nullable, required
  - `tax_identification_number` string, nullable, required
  - `website_url` string, nullable, required
  - `classifications` CompanyClassification[], required
    - `type` string, required
    - `code` string, required
    - `description` string, nullable
  - `beneficial_owners` union[], required
    - union
      - IndividualBeneficialOwner
        - `entity_type` 'individual', required
        - `name` string, required
        - `address` Address, required
          - `street_address` string, nullable, required
          - `street_address_2` string, nullable, required
          - `postal_code` string, nullable, required
          - `city` string, nullable, required
          - `state` string, nullable, required
          - `region` string, nullable, required
          - `country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
        - `position` string, nullable, required
        - `first_name` string, nullable, required
        - `middle_name` string, nullable, required — May contain multiple middle names
        - `last_name` string, nullable, required
        - `maiden_name` string, nullable, required
        - `birth_date` string, date, nullable, required — Date in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)(`yyyy-MM-dd` eg `2023-01-31`)
        - `birth_country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
        - `birth_place` string, nullable, required
        - `tax_identification_number` string, nullable, required
        - `voting_rights_percentage` number, float, nullable, required
        - `ownership_percentage` number, float, nullable, required
      - CompanyBeneficialOwner
        - `entity_type` 'company', required
        - `name` string, required
        - `address` Address, required
          - `street_address` string, nullable, required
          - `street_address_2` string, nullable, required
          - `postal_code` string, nullable, required
          - `city` string, nullable, required
          - `state` string, nullable, required
          - `region` string, nullable, required
          - `country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
        - `position` string, nullable, required
        - `registration_number` string, nullable, required
        - `tax_identification_number` string, nullable, required
        - `legal_form` string, nullable, required
        - `entity_legal_form` string, nullable, required — [ISO 20275](https://www.gleif.org/en/about-lei/iso-20275-entity-legal-forms-code-list) code (eg: `6CHY`)
        - `entity_legal_form_label` string, nullable, required — Label in the origin country language of the [ISO 20275](https://www.gleif.org/en/about-lei/iso-20275-entity-legal-forms-code-list) code. May contains multiple labels separated with a comma `,` when the code is assigned to multiple label in different languages.
        - `country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
        - `ownership_percentage` number, float, nullable, required
  - `shareholders` union[], required
    - union
      - IndividualShareholder
        - `entity_type` 'individual', required
        - `name` string, required
        - `address` Address, required
          - `street_address` string, nullable, required
          - `street_address_2` string, nullable, required
          - `postal_code` string, nullable, required
          - `city` string, nullable, required
          - `state` string, nullable, required
          - `region` string, nullable, required
          - `country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
        - `position` string, nullable, required
        - `first_name` string, nullable, required
        - `middle_name` string, nullable, required — May contain multiple middle names
        - `last_name` string, nullable, required
        - `maiden_name` string, nullable, required
        - `birth_date` string, date, nullable, required — Date in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)(`yyyy-MM-dd` eg `2023-01-31`)
        - `birth_country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
        - `birth_place` string, nullable, required
        - `tax_identification_number` string, nullable, required
        - `voting_rights_percentage` number, float, nullable, required
        - `ownership_percentage` number, float, nullable, required
      - CompanyShareholder
        - `entity_type` 'company', required
        - `name` string, required
        - `address` Address, required
          - `street_address` string, nullable, required
          - `street_address_2` string, nullable, required
          - `postal_code` string, nullable, required
          - `city` string, nullable, required
          - `state` string, nullable, required
          - `region` string, nullable, required
          - `country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
        - `position` string, nullable, required
        - `registration_number` string, nullable, required
        - `tax_identification_number` string, nullable, required
        - `legal_form` string, nullable, required
        - `entity_legal_form` string, nullable, required — [ISO 20275](https://www.gleif.org/en/about-lei/iso-20275-entity-legal-forms-code-list) code (eg: `6CHY`)
        - `entity_legal_form_label` string, nullable, required — Label in the origin country language of the [ISO 20275](https://www.gleif.org/en/about-lei/iso-20275-entity-legal-forms-code-list) code. May contains multiple labels separated with a comma `,` when the code is assigned to multiple label in different languages.
        - `country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
        - `ownership_percentage` number, float, nullable, required
  - `legal_representatives` union[], required
    - union
      - IndividualRepresentative
        - `entity_type` 'individual', required
        - `name` string, required
        - `address` Address, required
          - `street_address` string, nullable, required
          - `street_address_2` string, nullable, required
          - `postal_code` string, nullable, required
          - `city` string, nullable, required
          - `state` string, nullable, required
          - `region` string, nullable, required
          - `country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
        - `position` string, nullable, required
        - `first_name` string, nullable, required
        - `middle_name` string, nullable, required — May contain multiple middle names
        - `last_name` string, nullable, required
        - `maiden_name` string, nullable, required
        - `birth_date` string, date, nullable, required — Date in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)(`yyyy-MM-dd` eg `2023-01-31`)
        - `birth_country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
        - `birth_place` string, nullable, required
        - `tax_identification_number` string, nullable, required
        - `voting_rights_percentage` number, float, nullable, required
      - CompanyRepresentative
        - `entity_type` 'company', required
        - `name` string, required
        - `address` Address, required
          - `street_address` string, nullable, required
          - `street_address_2` string, nullable, required
          - `postal_code` string, nullable, required
          - `city` string, nullable, required
          - `state` string, nullable, required
          - `region` string, nullable, required
          - `country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
        - `position` string, nullable, required
        - `registration_number` string, nullable, required
        - `tax_identification_number` string, nullable, required
        - `legal_form` string, nullable, required
        - `entity_legal_form` string, nullable, required — [ISO 20275](https://www.gleif.org/en/about-lei/iso-20275-entity-legal-forms-code-list) code (eg: `6CHY`)
        - `entity_legal_form_label` string, nullable, required — Label in the origin country language of the [ISO 20275](https://www.gleif.org/en/about-lei/iso-20275-entity-legal-forms-code-list) code. May contains multiple labels separated with a comma `,` when the code is assigned to multiple label in different languages.
        - `country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
  - `merged_individuals` MergedIndividual[], required
    - `address` Address, required
      - `street_address` string, nullable, required
      - `street_address_2` string, nullable, required
      - `postal_code` string, nullable, required
      - `city` string, nullable, required
      - `state` string, nullable, required
      - `region` string, nullable, required
      - `country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
    - `position` string, nullable, required
    - `first_name` string, nullable, required
    - `middle_name` string, nullable, required — May contain multiple middle names
    - `last_name` string, nullable, required
    - `maiden_name` string, nullable, required
    - `birth_date` string, date, nullable, required — Date in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)(`yyyy-MM-dd` eg `2023-01-31`)
    - `birth_country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
    - `birth_place` string, nullable, required
    - `tax_identification_number` string, nullable, required
    - `voting_rights_percentage` number, float, nullable, required
    - `roles` string[], required — `legal_representative` `shareholder`
    - `ownership_percentage` number, float, nullable, required
    - `is_beneficial_owner` boolean, required
    - `is_business_contact` boolean, required
    - `gender` 'male' | 'female' | 'other', nullable, required — Gender of the individual (`male`, `female`, `other`)
    - `nationalities` string[], nullable, required — Nationalities as ISO 3166-1 alpha-2 country codes
    - `relations` MergedIndividualRelation[], required
      - `voting_rights_percentage` number, float, nullable, required
      - `ownership_percentage` number, float, nullable, required
      - `roles` string[], required — `legal_representative` `shareholder`
      - `position` string, nullable, required
  - `merged_companies` MergedCompany[], required
    - `name` string, required
    - `address` Address, required
      - `street_address` string, nullable, required
      - `street_address_2` string, nullable, required
      - `postal_code` string, nullable, required
      - `city` string, nullable, required
      - `state` string, nullable, required
      - `region` string, nullable, required
      - `country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
    - `registration_number` string, nullable, required
    - `tax_identification_number` string, nullable, required
    - `legal_form` string, nullable, required
    - `entity_legal_form` string, nullable, required — [ISO 20275](https://www.gleif.org/en/about-lei/iso-20275-entity-legal-forms-code-list) code (eg: `6CHY`)
    - `country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
    - `type` 'affiliated', required
    - `relations` MergedCompanyRelation[], required
      - `ownership_percentage` number, float, nullable, required
      - `roles` string[], required — `legal_representative` `shareholder`
      - `position` string, nullable, required

## Other responses

- `400` — The request is either malformed or contain invalid parameters. - Limit reached. Contact us at support@dotfile.com to lift all limits.

---

[API](https://skmtc.net/dotfile/apis/api-specifications.md) · [All operations](https://skmtc.net/dotfile/apis/api-specifications/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dotfile/api-specifications/versions/36393567057b/schema)