---
updatedAt: 2026-09-18T12:46:01.000Z
agentTools:
projectIndex: https://docs.sumsub.com/llms.txt
---
# Search companies for applicant
# Overview
Use this method to search for companies matching specific parameters across available registry packs.
### Note
The set of [input search parameters](https://docs.sumsub.com/sumsub/reference/company-search-parameters) varies depending on the connected sources.
## Required permissions
To use this method:
* Your [app token](https://docs.sumsub.com/sumsub/docs/app-tokens) must have the **Change applicant's personal data** [permission](https://docs.sumsub.com/sumsub/docs/user-roles#permissions).
* Your account must also have at least one of the following features enabled: **KYB Auto AML & Registry** or **full KYB**.
Both conditions are required â missing the permission, or having neither feature enabled, returns a `403 Forbidden`. If neither feature is enabled for your account, contact your CSM or Sumsub support.
# Request example
```curl
curl -X POST \
'https://api.sumsub.com/resources/api/companies/63e2428232f67079df800000/search?offset=0&limit=10' \
-H 'content-type: application/json' \
-H 'X-App-Token: ' \
-H 'X-App-Access-Sig: ' \
-H 'X-App-Access-Ts: ' \
-d '{
"companyName": "Super Company Ltd",
"country": "USA",
"number": "1234567890",
"state": "NV"
}'
```
# Response explained
The response is a JSON file representing the list of companies with related metadata.
The following is the root-level attribute:
| Field | Type | Description |
| :----- | :------------------------- | :---------------------------------------------------- |
| `list` | [Object](#list-attributes) | Includes data with `items`, `totalItems`, `pageInfo`. |
## `list` attributes
The following table explains the `list` attributes.
| Field | Type | Description |
| :----------- | :---------------------------------------- | :-------------------------------------------------------------------------- |
| `items` | [Array of objects](#items-element-fields) | Each item is an object representing an individual company with its details. |
| `totalItems` | Integer | Total number of the companies found. |
| `pageInfo` | [Object](#pageinfo-attributes) | Applied limit and offset settings. |
## `items` element fields
The following table explains the `items` element fields representing the note details.
| Field | Type | Description |
| -------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | String | Unique identifier (`searchItemId`) of the company in the search results.
You can use this identifier later with the [Get company details by search item ID](https://docs.sumsub.com/sumsub/reference/get-company-details-by-search-item-id) method. |
| `country` | String | [Alpha-3 code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) of the country where the company is legally registered (for example, `DEU`, `GBR`, `CYP`). |
| `state` | String | Two-letter code representing a state, province, region, jurisdiction, or similar administrative area.
Applicable to the USA and Canada. |
| `registrationNumber` | String | Unique number that is assigned to the company when it was registered as a legal entity. |
| `companyName` | String | Name of the company. |
| `address` | String | Address in a human-readable format. For example, `Suite 502, Meridian Square Business Centre, 14 Kingsway Wharf, London NW0 0AA, United Kingdom`. |
## `pageInfo` attributes
The following table explains the `pageInfo` attributes.
| Field | Type | Description |
| :------- | :------ | :------------------------------ |
| `limit` | Integer | Applied to the response limit. |
| `offset` | Integer | Applied to the response offset. |
# Response examples
If the request is successfully sent and processed, you will get a response like the following:
```json
{
"list": {
"items": [
{
"id": "521bfb53-4484-4842-9746-8e6bc337d101:0",
"country": "CYP",
"state": null,
"registrationNumber": "99999999",
"companyName": "Demo Company With Beneficiaries Ltd",
"address": "Suite 502, Meridian Square Business Centre, 14 Kingsway Wharf, London NW0 0AA, United Kingdom"
},
{
"id": "521bfb53-4484-4842-9746-8e6bc337d101:1",
"country": "CYP",
"state": null,
"registrationNumber": "88888888",
"companyName": "Demo Company Ltd",
"address": "Suite 502, Meridian Square Business Centre, 14 Kingsway Wharf, London NW0 0AA, United Kingdom"
},
{
"id": "521bfb53-4484-4842-9746-8e6bc337d101:2",
"country": "CYP",
"state": null,
"registrationNumber": "777777777",
"companyName": "Demo Company Inactive Ltd",
"address": "Suite 502, Meridian Square Business Centre, 14 Kingsway Wharf, London NW0 0AA, United Kingdom"
}
],
"totalItems": 3,
"pageInfo": {
"limit": 10,
"offset": 0
}
}
}
```
If the request fails, you will receive an HTTP response containing an error code along with a message explaining the error. For example:
```json
{
"code": 403,
"correlationId": "82ce8a0f21e4cfa06637f837e0f95493",
"description": "User not authorized."
}
```
If no companies have been found, the response returns an empty items array:
```json
{
"list": {
"items": [],
"totalItems": 0,
"pageInfo": {
"limit": 10,
"offset": 0
}
}
}
```
# Possible errors
| Error code | Description |
| ---------- | --------------------------------------------------- |
| **9501** | No data source is enabled for the selected country. |
| **9105** | Company search limit was reached. |
| **9100** | Input is not supported. |
| **9504** | External service failure. |
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "sumsub-api",
"version": "1.0"
},
"servers": [
{
"url": "https://api.sumsub.com"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"name": "X-App-Token",
"in": "header",
"x-default": ""
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/resources/api/companies/{applicantId}/search": {
"post": {
"description": "",
"responses": {
"200": {
"description": ""
}
},
"parameters": [
{
"in": "path",
"name": "applicantId",
"schema": {
"type": "string"
},
"required": true,
"description": "Unique identifier of the company applicant in the Sumsub system.
This identifier is a random combination of 24 digits and lowercase Latin characters. It is automatically generated when the applicant profile is created on the Sumsub side, and can be found in the [Dashboard](https://cockpit.sumsub.com/checkus/#/applicants/company?limit=10&page=0).
If the `applicantId` is unknown to you, use the [Get applicant data (externalUserId)](https://docs.sumsub.com/sumsub/reference/get-applicant-data-via-externaluserid) method to fetch it."
},
{
"in": "query",
"name": "offset",
"schema": {
"type": "integer",
"format": "int32",
"default": "0"
},
"description": "Offset of the companies to return. The value cannot exceed `100`."
},
{
"in": "query",
"name": "limit",
"schema": {
"type": "integer",
"format": "int32",
"default": "10"
},
"description": "Maximum number of companies to return. The value must be greater than `0` and cannot exceed `10`."
}
],
"operationId": "post_resources-api-companies-applicantid-search",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"country": {
"type": "string",
"description": "Alpha-3 code of the country where the company is legally registered (for example, `DEU`, `GBR`, `CYP`)."
},
"state": {
"type": "string",
"description": "Two-letter code representing a state, province, region, jurisdiction, or similar administrative area.\n\nâ ď¸ Applicable to the USA and Canada."
},
"companyName": {
"type": "string",
"description": "Name of the company. Maximum length: 250 characters.\n\nâ ď¸ The set of [input search parameters](https://docs.sumsub.com/sumsub/reference/company-search-parameters) varies depending on the connected sources."
},
"number": {
"type": "string",
"description": "Registration or identification number of the company. Maximum length: 100 characters."
}
}
}
}
}
},
"summary": "Search companies for applicant"
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```