Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Get a table’s metadata and current processing status.
Billing: Free.
curl --request GET \
--url https://api.lusha.com/v3/contacts/tables/{table_id} \
--header 'api_key: <api-key>'import requests
url = "https://api.lusha.com/v3/contacts/tables/{table_id}"
headers = {"api_key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {api_key: '<api-key>'}};
fetch('https://api.lusha.com/v3/contacts/tables/{table_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api.lusha.com/v3/contacts/tables/{table_id}")
.header("api_key", "<api-key>")
.asString();package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/contacts/tables/{table_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("api_key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"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,
"isProcessing": false,
"columns": [
{
"columnId": "c1",
"name": "Job title",
"type": "lusha",
"key": "jobTitle",
"isDefault": false,
"addedAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"rowsNotRun": 123,
"rowsProcessing": 123,
"rowsSuccess": 123,
"rowsNoData": 123,
"rowsFailed": 123
}
]
},
"billing": {
"creditsCharged": 3,
"resultsReturned": 1
}
}Your Lusha API key. You can find this in your Lusha dashboard under API settings.
Include this key in the api_key header for all requests.
The table's ID.
Email of the user making the request. Used to scope ownership/visibility checks on GET/DELETE calls, which cannot carry a body.
Was this page helpful?
curl --request GET \
--url https://api.lusha.com/v3/contacts/tables/{table_id} \
--header 'api_key: <api-key>'import requests
url = "https://api.lusha.com/v3/contacts/tables/{table_id}"
headers = {"api_key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {api_key: '<api-key>'}};
fetch('https://api.lusha.com/v3/contacts/tables/{table_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api.lusha.com/v3/contacts/tables/{table_id}")
.header("api_key", "<api-key>")
.asString();package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/contacts/tables/{table_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("api_key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"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,
"isProcessing": false,
"columns": [
{
"columnId": "c1",
"name": "Job title",
"type": "lusha",
"key": "jobTitle",
"isDefault": false,
"addedAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"rowsNotRun": 123,
"rowsProcessing": 123,
"rowsSuccess": 123,
"rowsNoData": 123,
"rowsFailed": 123
}
]
},
"billing": {
"creditsCharged": 3,
"resultsReturned": 1
}
}