---
title: "POST /resources/api/companies/{applicantId}/search/fetch"
method: POST
path: "/resources/api/companies/{applicantId}/search/fetch"
tags: ["CompanySearchPublicApiResource"]
---

# POST /resources/api/companies/{applicantId}/search/fetch

`POST /resources/api/companies/{applicantId}/search/fetch`

## Path parameters

- `applicantId` string, required

## Request body

- CompanyFetchRequestPublicApiDto
  - `searchItemId` string

## Response `default`

default response

- ApplicantCompanyInfo — ⚠️ Required to only create a company applicant profile. Contains [general information](#specifics-of-importing-company-applicants-data) about the company.
  - `address` Address — Company address details.
    - `buildingName` string — Building name (if applicable).
    - `buildingNumber` string — Building number.
    - `country` string — Alpha-3 country code (for example, `DEU`, `GBR`, `ARG`, and so on).
    - `endDate` string, date-time
    - `flatNumber` string — Flat or apartment number.
    - `formattedAddress` string
    - `locationPosition` LocationPosition
      - `formattedAddress` string
      - `locationCoords` LocationCoords
        - `accuracy` number, double
        - `lat` number, double
        - `lon` number, double
      - `skipped` boolean
    - `postCode` string — Address postal code.
    - `providedLocationPosition` LocationPosition
      - `formattedAddress` string
      - `locationCoords` LocationCoords
        - `accuracy` number, double
        - `lat` number, double
        - `lon` number, double
      - `skipped` boolean
    - `source` 'manual' | 'autoComplete' | 'gps' | 'externalDb' | 'proofOfAddress' | 'proofOfIdentity'
    - `startDate` string, date-time
    - `state` string — State, region, district, county or another territorial entity inside a country.
    - `stateCode` string
    - `stateEn` string
    - `street` string — Street name.
    - `streetEn` string
    - `subStreet` string — Additional information related to the street. This could be a house number or any other details.
    - `subStreetEn` string
    - `town` string — City, town, or another settlement.
    - `townEn` string
  - `alternativeNames` string[]
  - `applicantPosition` string
  - `beneficiaries` CompanyBeneficiary[] — Each object contains the `applicantId` of a beneficiary and additional information, such as their type and position within the company.
    - `applicantId` string — Unique applicant identifier of the beneficiary in the Sumsub system. <br><br>If the `applicantId` is unknown to you, use the [Get applicant data (externalUserId)](https://docs.sumsub.com/reference/get-applicant-data-via-externaluserid) method to fetch it.
    - `appointedOn` string, date-time
    - `beneficiaryInfo` CompanyBeneficiaryInfo
      - `alternativeNames` string[]
      - `buildingNumber` string
      - `companyName` string
      - `controlScheme` string
      - `country` string
      - `countryOfBirth` string
      - `dob` string, date-time
      - `email` string
      - `externalUserId` string
      - `firstName` string
      - `flatNumber` string
      - `gender` string
      - `incorporatedOn` string, date-time
      - `lastName` string
      - `legalAddress` string
      - `legalName` string
      - `leiCode` string
      - `metadata` ApplicantMetadataKV[]
        - `key` string
        - `value` string
      - `middleName` string
      - `nationality` string
      - `phone` string
      - `placeOfBirth` string
      - `postCode` string
      - `postalAddress` string
      - `registrationLocation` string
      - `registrationNumber` string
      - `shareSize` number, double
      - `state` string
      - `stateOfBirth` string
      - `street` string
      - `subStreet` string
      - `taxId` string
      - `taxResidenceCountry` string
      - `tin` string
      - `town` string
      - `type` string
      - `website` string
    - `id` string
    - `imageIds` string[] — Image IDs of the uploaded document. If the `imageIds` array contains more than one element, the first one would be the front side and the others — back sides.
    - `inRegistry` boolean — Matching to a Corporate registry.<ul><li><code>true</code> — found in the registry.</li><li><code>false</code> — not found.</li><li><code>null</code> — unknown.</li></ul>
    - `matched` boolean
    - `natureOfControl` string
    - `positions` string[] — Positions in the company (`director`, `shareholder`, `other`) that the beneficiary is holding. Add one position per string.<br><br>⚠️ Not required for KYB 2.0.</p>
    - `resignedOn` string, date-time
    - `shareSize` number, double — Percentage of ownership if the beneficiary is a shareholder of the company.
    - `submitted` boolean
    - `subtypes` CompanyBeneficiarySubtype[]
    - `type` 'shareholder' | 'representative' | 'director' | 'ubo' | 'companyOfficer' | 'secretary' | 'founder' | 'investor' | 'legalAdvisor' | 'authorizedSignatory' | 'trustee' | 'trustBeneficiary' | 'trustSettlor' | 'trustProtector' | 'payer'
    - `types` CompanyBeneficiaryType[]
  - `companyName` string — The name of the company.
  - `companyNameEn` string
  - `controlScheme` string — Description of the control scheme of the company ownership or group of entities.
  - `country` string — Alpha-3 code of the country where the company is legally registered (for example, `DEU`, `GBR`, `ARG`, and so on).
  - `customInfo` ApplicantCompanyInfoCustomInfoItem[]
    - `key` string
    - `value` string
  - `email` string — Company email address.
  - `incorporatedOn` string, date-time — The date of company incorporation (format `YYYY-mm-dd`, e.g. `2001-09-25`).
  - `legalAddress` string — The address a legal entity uses to register with a legal authority.
  - `legalForm` string
  - `leiCode` string
  - `licenseNumber` string
  - `noDirectors` boolean
  - `noDocs` boolean
  - `noRepresentatives` boolean
  - `noShareholders` boolean — When set to `true`, a company is to be verified with no shareholders specified in the company profile. For example, in case when the verification level settings require a company to have three shareholders but the company has just one.
  - `noUBOs` boolean — When set to `true`, a company is to be verified with no UBOs specified in the company profile. For example, in case when another legal entity that cannot be a UBO owns this company.
  - `ownershipStructureDepth` integer
  - `phone` string — Company phone number.
  - `postalAddress` string — Company postal address.
  - `registrationLocation` string — City, town, or another location where the company was registered.
  - `registrationNumber` string — Unique number assigned to the company when it was registered as a legal entity.
  - `skippedTypes` CompanyBeneficiaryType[]
  - `taxId` string — Taxpayer registration number/Code of taxpayer registration.
  - `type` string — Type of legal entity. For example, `Private Company Limited by Shares`, `Public Limited Company`, `Limited Partnership`, and so on.
  - `upcomingDocumentExpiration` CompanyDocumentExpirationInfo
    - `expirationDate` string, date-time
    - `idDocSubType` 'FRONT_SIDE' | 'BACK_SIDE' | 'PAGES' | 'INCORPORATION_CERT' | 'INCORPORATION_ARTICLES' | 'ARTICLES_OF_ASSOCIATION' | 'PARTNERSHIP_AGREEMENT' | 'REGULATORY_LICENSE' | 'TRADE_LICENSE' | 'SHAREHOLDER_REGISTRY' | 'DIRECTORS_REGISTRY' | 'STATE_REGISTRY' | 'OWNERSHIP_STRUCTURE_CHART' | 'INCUMBENCY_CERT' | 'PROOF_OF_ADDRESS' | 'TAX_CERT' | 'PROOF_OF_NATURE_OF_BUSINESS' | 'SELF_DECLARATION_FORM' | 'POWER_OF_ATTORNEY' | 'PROOF_OF_DOMAIN' | 'TRUST_AGREEMENT' | 'INFORMATION_STATEMENT' | 'GOOD_STANDING_CERT' | 'OTHER'
    - `idDocType` 'ID_CARD' | 'PASSPORT' | 'TRAVEL_PASSPORT' | 'DRIVERS' | 'SNILS' | 'RESIDENCE_PERMIT' | 'WORK_PERMIT' | 'WORK_PATENT' | 'VISA' | 'EMPLOYMENT_CERTIFICATE' | 'DRIVERS_TRANSLATION' | 'PASSPORT_TRANSLATION' | 'UTILITY_BILL' | 'UTILITY_BILL2' | 'ID_AS_POA' | 'SELFIE' | 'VIDEO_SELFIE' | 'PAYMENT_SELFIE' | 'STUDENT_ID' | 'BANK_CARD' | 'PROOF_OF_PAYMENT' | 'BANK_STATEMENT' | 'PROFILE_IMAGE' | 'PROFILE_SCREENSHOT' | 'ID_DOC_PHOTO' | 'MRZ_DOCUMENT' | 'AGREEMENT' | 'OTHER' | 'OTHER2' | 'OTHER3' | 'CONTRACT' | 'SIGNED_CONTRACT' | 'INVESTOR_DOC' | 'COMPANY_DOC' | 'VAT_CERTIFICATE' | 'POWER_OF_ATTORNEY' | 'TRANSPARENCY_REGISTRY_EXTRACT' | 'INCOME_SOURCE' | 'VEHICLE_REGISTRATION_CERTIFICATE' | 'VEHICLE_PASSPORT' | 'LEGAL_ENTITY' | 'MIGRATION_CARD' | 'ARRIVAL_NOTICE' | 'PAYMENT_METHOD' | 'PAYMENT_SOURCE' | 'INSURANCE_CERTIFICATE' | 'TAXI_LICENSE' | 'COVID_VACCINATION_FORM' | 'COVID_TEST_FORM' | 'TAX_PAYER_NUMBER_DOC' | 'FILE_ATTACHMENT' | 'ARBITRARY_DOC' | 'VOTER_ID' | 'IDENTITY_VIDEO' | 'EXTERNAL_DB_DOC' | 'DEBUG'
    - `imageId` integer
  - `website` string — Website URL of the company.

---

[API](https://skmtc.net/sumsub/apis/sumsub-api-service.md) · [All operations](https://skmtc.net/sumsub/apis/sumsub-api-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sumsub/sumsub-api-service/revisions/cd1cf0bbd4f9/schema)