---
title: "Get Contacts Table Entities"
method: GET
path: "/v3/contacts/tables/{table_id}/entities"
tags: ["Contacts Tables"]
---

# Get Contacts Table Entities

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

Read a page of rows in the table, with all column values and per-cell status.

> **Billing:** Charged per row returned via `export_api`.

## Path parameters

- `table_id` string, required

## Query parameters

- `email` string, email
- `page` integer
- `size` integer

## Response `200`

Successful response

- EntitiesGetResponse
  - `data` TableEntity[]
    - `id` string — Encrypted Lusha ID.
    - `columns` EntityColumnValue[]
      - `id` string
      - `name` string
      - `type` string
      - `sourceType` string
      - `value` string, nullable — The cell's data. Shape depends on the column type.
      - `status` 'not_run' | 'processing' | 'success' | 'no_data' | 'failed' — Current state of a single cell's data. `no_data` means the run succeeded but found nothing — distinct from `failed`, which means the run itself errored.
  - `pagination` V3PaginationResponse
    - `page` integer
    - `size` integer
    - `total` 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)