Dex Guide
Dex Dashboard
Companies

Export companies as CSV

Download the workspace's companies as one CSV file, ordered by name, then id. The body takes exactly one of three shapes: `{ company_ids }` (1-50,000 ids; archived companies included, ids outside the

POST /v2/companies/export

Request body

Content-Type: application/json

company_ids
array<string (uuid)>
where
object
where.name
object
where.name.operator
string enum
Possible values: "contains", "not_contains", "eq"
where.name.value
string
where.search
string
where.description
object
where.description.operator
string enum
Possible values: "contains", "not_contains"
where.description.value
string
where.headquarters_location
object
where.headquarters_location.operator
string enum
Possible values: "contains", "not_contains", "eq"
where.headquarters_location.value
string
where.employees
object
where.employees.in
array<string enum>
where.connections
object
where.connections.operator
string enum
Possible values: "eq", "gte", "lte"
where.connections.value
integer
where.country_code
object
where.country_code.operator
string enum
Possible values: "in", "not_in"
where.country_code.values
array<string>
where.linkedin_industry
object
where.linkedin_industry.operator
string enum
Possible values: "in", "not_in"
where.linkedin_industry.values
array<string>
where.linkedin_company_type
object
where.linkedin_company_type.operator
string enum
Possible values: "in", "not_in"
where.linkedin_company_type.values
array<string enum>
where.assignee
object
where.assignee.operator
string enum
Possible values: "in", "not_in"
where.assignee.values
array<string enum>
where.tags
object
where.tags.operator
string enum
Possible values: "any", "all", "none"
where.tags.tag_ids
array<string (uuid)>
where.starred
boolean
where.archived
boolean
where.custom_fields
array<object>
where.custom_fields[].field_id
string (uuid)
where.custom_fields[].operator
string enum
Possible values: "contains", "eq", "in", "not_in", "present", "absent", "gte", "lte"
where.custom_fields[].value
string
view_id
string (uuid)
selection_id
string
Opaque token from POST /v2/companies/selections.

Example

{
  "company_ids": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "where": {
    "name": {
      "operator": "contains",
      "value": "string"
    },
    "search": "string"
  }
}

Responses

200 — The CSV file, UTF-8 with a byte-order mark and CRLF line endings, streamed as it is written.

Content-Type: text/csv

(body)
string (binary)

Example

"string"

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/export \
  --request POST \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_ids": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "where": {
    "name": {
      "operator": "contains",
      "value": "string"
    },
    "search": "string"
  }
}'

Freeze a company selection

Resolve `where` (the `POST /v2/companies/filter` filter) and optional `view_id`, less `excluded_ids` (up to 10,000), once, and store the ids for 1 hour under a token bound to the caller, the workspace

Plan a companies CSV import

Classify up to 500 CSV rows against the workspace's companies without writing anything. Each row carries raw trimmed cells (`fields`, with blank cells omitted), an optional `id`, `owner_email`, `tags`

Copyright © 2026