v1

latestOpenAPI 3.0.3Proprietary2026-08-0656136286.9 KB
Contacts Tables

Get Contacts Table

Get a table's metadata and current processing status.

Billing: Free.

get/v3/contacts/tables/{table_id}

Path parameters

table_idstring required

The table's ID.

Query parameters

emailstring email

Email of the user making the request. Used to scope ownership/visibility checks on GET/DELETE calls, which cannot carry a body.

Response

Successful response

Example response

{
  "data": {
    "tableId": "482910",
    "name": "VP Sales US Tech Q2",
    "entityType": "contacts",
    "visibility": "private",
    "status": "active",
    "owner": {
      "id": 12345,
      "email": "owner@lusha.com",
      "name": "Ada Lovelace"
    },
    "createdBy": {
      "surface": "api",
      "createdByUserId": 12345
    },
    "workspaceUrl": "https://workspace.lusha.com/tables/482910",
    "entityCount": 5,
    "columns": [
      {
        "columnId": "c1",
        "name": "Job title",
        "type": "lusha",
        "key": "jobTitle"
      }
    ]
  },
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}