---
title: "List selectable search columns"
method: GET
path: "/api/v1/contacts/columns"
tags: ["Search"]
---

# List selectable search columns

`GET /api/v1/contacts/columns`

## Request

- Base URL: `https://app.getleads.io`
- URL: `https://app.getleads.io/api/v1/contacts/columns`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Catalog of fields for `columns` / `where_sql` on the active dataset
(0 credits). The new database has about 85 exportable columns; Classic-only names
such as NAICS, traffic, per-tech columns, and role counts are gone.
A 400 from search includes `column_replacements` for those names.

## Query parameters

- `group` string
- `searchable_only` boolean
- `exportable_only` boolean

## Response `200`

Column catalog

- object
  - `ok` boolean
  - `fields` object[]
  - `count` integer
  - `searchable_field_count` integer
  - `dataset` string
  - `credits_used` 0

## Other responses

- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/getleads/apis/getleads-api.md) - [All operations](https://skmtc.dev/getleads/apis/getleads-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getleads/apis/getleads-api/revisions/f5dbc32e0c3a?raw)