Companies

Search companies

Typeahead over the workspace's active companies: matches `query` (required, trimmed, 1-100 characters; 400 when blank) accent-insensitively against the name, the website's domain (scheme, `www.` and p

GET /v2/companies/search

Parameters

Query parameters

query

string required

take

integer

Responses

200 — Successful response

Content-Type: application/json

data

object required

data.companies

array<object> required

data.companies[].id

string (uuid) required

data.companies[].user_id

string required

data.companies[].workspace_id

string (uuid) | null required

data.companies[].assignee_id

string | null required

data.companies[].name

string required

data.companies[].description

string | null required

data.companies[].linkedin_description

string | null required

data.companies[].logo_url

string | null required

data.companies[].website_url

string | null required

data.companies[].linkedin_slug

string | null required

data.companies[].facebook_slug

string | null required

data.companies[].x_slug

string | null required

data.companies[].instagram_slug

string | null required

data.companies[].headquarters_location

string | null required

data.companies[].country_code

string | null required

data.companies[].email

string | null required

data.companies[].phone_number

string | null required

data.companies[].arr_estimate

integer | null required

data.companies[].number_of_employees

integer | null required

data.companies[].linkedin_data

object | null required

data.companies[].linkedin_data.industry

string

data.companies[].linkedin_data.company_type

string

data.companies[].linkedin_data.size_range

string

data.companies[].linkedin_data.specialities

array<string>

data.companies[].ignore_merge

boolean required

data.companies[].archived_at

string (date-time) required

data.companies[].created_at

string (date-time) required

data.companies[].updated_at

string (date-time) required

data.companies[].companies_custom_fields

array<object> required

data.companies[].companies_custom_fields[].custom_field_id

string (uuid) required

data.companies[].companies_custom_fields[].text_value

string | null required

data.companies[].companies_custom_fields[].array_value

array<string> required

data.companies[].companies_custom_fields[].date_value

string (date-time) required

data.companies[].companies_custom_fields[].member_user_id

string | null required

data.companies[].companies_custom_fields[].number_value

number | null required

data.companies[].companies_custom_fields[].boolean_value

boolean | null required

data.companies[].companies_custom_fields_contacts

array<object> required

data.companies[].companies_custom_fields_contacts[].custom_field_id

string (uuid) required

data.companies[].companies_custom_fields_contacts[].linked_contact_id

string (uuid) required

data.companies[].companies_custom_fields_companies

array<object> required

data.companies[].companies_custom_fields_companies[].custom_field_id

string (uuid) required

data.companies[].companies_custom_fields_companies[].linked_company_id

string (uuid) required

data.companies[].tag_ids

array<string (uuid)> required

data.pagination

object

data.pagination.nextCursor

string | null

data.pagination.count

integer

Example

{
  "data": {
    "companies": [
      {
        "id": "00000000-0000-0000-0000-000000000000",
        "user_id": "string",
        "workspace_id": "00000000-0000-0000-0000-000000000000",
        "assignee_id": "string",
        "name": "string",
        "description": "string",
        "linkedin_description": "string",
        "logo_url": "string",
        "website_url": "string",
        "linkedin_slug": "string",
        "facebook_slug": "string",
        "x_slug": "string",
        "instagram_slug": "string",
        "headquarters_location": "string",
        "country_code": "string",
        "email": "string",
        "phone_number": "string",
        "arr_estimate": 0,
        "number_of_employees": 0,
        "linkedin_data": {
          "industry": "string",
          "company_type": "string"
        },
        "ignore_merge": false,
        "archived_at": "2026-10-23T10:31:51.478Z",
        "created_at": "2026-10-23T10:31:51.478Z",
        "updated_at": "2026-10-23T10:31:51.478Z",
        "companies_custom_fields": [
          {
            "custom_field_id": "00000000-0000-0000-0000-000000000000",
            "text_value": "string",
            "array_value": [
              null
            ],
            "date_value": "2026-10-23T10:31:51.478Z",
            "member_user_id": "string",
            "number_value": 0,
            "boolean_value": false
          }
        ],
        "companies_custom_fields_contacts": [
          {
            "custom_field_id": "00000000-0000-0000-0000-000000000000",
            "linked_contact_id": "00000000-0000-0000-0000-000000000000"
          }
        ],
        "companies_custom_fields_companies": [
          {
            "custom_field_id": "00000000-0000-0000-0000-000000000000",
            "linked_company_id": "00000000-0000-0000-0000-000000000000"
          }
        ],
        "tag_ids": [
          "00000000-0000-0000-0000-000000000000"
        ]
      }
    ]
  }
}

400 — Request body failed validation.

Content-Type: application/json

(body)

any

401 — Missing or invalid API key.

Content-Type: application/json

(body)

any

403 — Valid key, insufficient permission.

Content-Type: application/json

(body)

any

404 — Resource does not exist.

Content-Type: application/json

(body)

any

409 — Request conflicts with the current state of the resource.

Content-Type: application/json

(body)

any

429 — Rate limit exceeded.

Content-Type: application/json

(body)

any

500 — Unexpected server error.

Content-Type: application/json

(body)

any

Code samples

curl 'https://api.prod.getdex.com/v2/companies/search?query=string' \
  --header 'Authorization: Bearer YOUR_API_KEY'

fetch('https://api.prod.getdex.com/v2/companies/search?query=string', {
  headers: {
    Authorization: 'Bearer YOUR_API_KEY'
  }
})

requests.get(
    "https://api.prod.getdex.com/v2/companies/search",
    headers={
      "Authorization": "Bearer YOUR_API_KEY"
    },
    params={
      "query": "string"
    }
)

Create a company

Create a company in the workspace. `name` is required (1-150 characters, trimmed); names need not be unique. `website_url` is stored as typed, with `https://` added when no scheme is given; another co

Get a company

Get one company by its ID, archived or not. 404 `record_not_found` when it is not in the workspace. Workspace-only: send the `X-Dex-Workspace` header (404 `record_not_found` without it). Returns `{ da