---
title: "Get Contacts Column Catalog"
method: GET
path: "/v3/contacts/tables/columns"
tags: ["Contacts Tables"]
---

# Get Contacts Column Catalog

`GET /v3/contacts/tables/columns`

## Request

- Base URL: `https://api.lusha.com`
- URL: `https://api.lusha.com/v3/contacts/tables/columns`
- Auth: API key in header `api_key`
- TypeScript: <https://skmtc.dev/lusha/apis/lusha-api-documentation/docs/v3/contacts/tables/columns/get.ts> (a function with typed inputs; its response is checked against the schema)

List every Lusha data column that can be added to a contacts table — 22 columns.

No request body and no parameters. Each entry returns the column's `category`,
`displayName` (e.g. "Job title"), `columnKey` (e.g. `jobTitle` — the key you pass to
[Add Columns to Contacts Table](#operation/addContactsTableColumns)), and `type`
(`string` / `number` / `object`).

> **Not the same as** [List Contacts Table Columns](#operation/listContactsTableColumns).
> That endpoint lists the columns a *specific table already has*; this one lists
> what's *available to add*.

> **Billing:** Free — no credits charged.

## Response `200`

Successful response

- ColumnCatalogResponse: The full catalog of Lusha columns available for this entity type — 22 for contacts, 46 for companies.
  - `data` ColumnCatalogItem[]
    - `category` string: Grouping the column belongs to in the catalog and in the Workspace UI.
    - `displayName` string: Human-readable column name, as shown on the table.
    - `columnKey` string: Stable machine key for this column. Pass this value as `columnKey` when adding the column to a table.
    - `type` 'string' | 'number' | 'object': Data type of the values this column produces.
  - `billing` V3Billing: Credit usage summary for a V3 API request
    - `creditsCharged` integer: Total credits charged for this request
    - `resultsReturned` integer: Number of successful results returned

## Other responses

- `401`: Unauthorized - invalid or missing API key
- `403`: Forbidden - account inactive, V3 access not enabled, or plan does not include this feature

## Changes

- **2026-09-11** `061e7f600fb8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lusha/apis/lusha-api-documentation/changes/v3/contacts/tables/columns/get.md)

---

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