# Get Contacts Table 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.

Endpoint: GET /v3/contacts/tables/{table_id}/entities
Security: ApiKeyAuth

## Path parameters:

  - `table_id` (string, required)
    The table's ID.
    Example: "482910"

## Query parameters:

  - `email` (string)
    Email of the user making the request. Used to scope ownership/visibility checks on GET/DELETE calls, which cannot carry a body.
    Example: "user@example.com"

  - `page` (integer)

  - `size` (integer)

## Response 200 fields (application/json):

  - `data` (array)

  - `data.id` (string)
    Encrypted Lusha ID.
    Example: "v1.aB3kZ9example"

  - `data.columns` (array)

  - `data.columns.id` (string)
    Example: "f8c1a2b3"

  - `data.columns.name` (string)
    Example: "company_name"

  - `data.columns.type` (string)
    Example: "string"

  - `data.columns.sourceType` (string)
    Example: "lusha"

  - `data.columns.value` (any,null)
    The cell's data. Shape depends on the column type.
    Example: "Google"

  - `data.columns.status` (string)
    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.
    Enum: "not_run", "processing", "success", "no_data", "failed"

  - `pagination` (object)

  - `pagination.page` (integer)

  - `pagination.size` (integer)
    Example: 25

  - `pagination.total` (integer)

  - `billing` (object)
    Credit usage summary for a V3 API request

  - `billing.creditsCharged` (integer)
    Total credits charged for this request
    Example: 3

  - `billing.resultsReturned` (integer)
    Number of successful results returned
    Example: 1

## Response 401 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]