Contact Tables

Get Contacts Column Catalog

List every Lusha data column that can be added to a contacts table - 22 columns.

No request body and no parameters. Each entry returns the column’s category, displayName (e.g. “Job title”), columnKey (e.g. jobTitle - the key you pass to Add Columns to Contacts Table), and type (string / number / object).

Not the same as List Contacts Table Columns. That endpoint lists the columns a specific table already has; this one lists what’s available to add.

Billing: Free - no credits charged.

GET

contacts

tables

columns

Get Contacts Column Catalog

curl --request GET \
  --url https://api.lusha.com/v3/contacts/tables/columns \
  --header 'api_key: <api-key>'

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://api.lusha.com/v3/contacts/tables/columns', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.lusha.com/v3/contacts/tables/columns"

	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": [
    {
      "category": "Contact details",
      "displayName": "Job title",
      "columnKey": "jobTitle",
      "type": "string"
    },
    {
      "category": "Contact details",
      "displayName": "Seniority",
      "columnKey": "seniority",
      "type": "string"
    },
    {
      "category": "Company",
      "displayName": "Company size",
      "columnKey": "companyEmployeeCount",
      "type": "number"
    },
    {
      "category": "Company",
      "displayName": "Location",
      "columnKey": "location",
      "type": "object"
    }
  ],
  "billing": {
    "creditsCharged": 0,
    "resultsReturned": 22
  }
}

Authorizations

api_key

string

header

required

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.

Response

Successful response

The full catalog of Lusha columns available for this entity type - 22 for contacts, 46 for companies.

data

object[]

Show child attributes

billing

object

Credit usage summary for a V3 API request

Show child attributes

⌘I

Get Contacts Column Catalog

curl --request GET \
  --url https://api.lusha.com/v3/contacts/tables/columns \
  --header 'api_key: <api-key>'

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://api.lusha.com/v3/contacts/tables/columns', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.lusha.com/v3/contacts/tables/columns"

	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": [
    {
      "category": "Contact details",
      "displayName": "Job title",
      "columnKey": "jobTitle",
      "type": "string"
    },
    {
      "category": "Contact details",
      "displayName": "Seniority",
      "columnKey": "seniority",
      "type": "string"
    },
    {
      "category": "Company",
      "displayName": "Company size",
      "columnKey": "companyEmployeeCount",
      "type": "number"
    },
    {
      "category": "Company",
      "displayName": "Location",
      "columnKey": "location",
      "type": "object"
    }
  ],
  "billing": {
    "creditsCharged": 0,
    "resultsReturned": 22
  }
}

Overview

Resources

Endpoints

Get Contacts Column Catalog

Authorizations

Response