---
title: "List Contacts Table Columns"
method: GET
path: "/v3/contacts/tables/{table_id}/columns"
tags: ["Contacts Tables"]
---

# List Contacts Table Columns

`GET /v3/contacts/tables/{table_id}/columns`

List the columns on a table, with type and aggregated per-cell status counts.

> **Billing:** Free.

## Path parameters

- `table_id` string, required

## Query parameters

- `email` string, email

## Response `200`

Successful response

- ColumnsListResponse — Response for List Columns — `data` is a bare array of ColumnDto.
  - `data` ColumnSummary[]
    - `columnId` string
    - `name` string
    - `type` 'lusha' | 'crm' | 'signal' | 'ai' | 'score'
    - `key` string, nullable
    - `isDefault` boolean — Default Lusha columns cannot be removed.
    - `addedAt` string, date-time
    - `updatedAt` string, date-time
    - `rowsNotRun` integer
    - `rowsProcessing` integer
    - `rowsSuccess` integer
    - `rowsNoData` integer
    - `rowsFailed` integer
  - `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
- `404` — Not found - table does not exist or is not accessible to this account

---

[API](https://skmtc.net/lusha/apis/lusha-api-documentation.md) · [All operations](https://skmtc.net/lusha/apis/lusha-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lusha/lusha-api-documentation/versions/4c51e40e3e67/schema)