v1

latestOpenAPI 3.0.3Proprietary2026-08-0656136286.9 KB

Contacts Tables

List Contacts Tables

List contacts tables owned by the given user, plus any tables shared with the account.

Billing: Free.

post/v3/contacts/tables/list

Request body

pageinteger

sizeinteger

namestring

Optional filter — matches tables whose name contains this text.

status'active' | 'archived'

deleted is not a filterable status.

Example request

{
  "owner": {
    "email": "user@example.com"
  },
  "name": "Q3"
}

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"
    }
  ],
  "pagination": {
    "size": 25
  },
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}