Skip to main content
GET
/
contacts
/
export
Export Contact List
curl --request GET \
  --url https://api.lemlist.com/api/contacts/export \
  --header 'Authorization: Basic <encoded-value>'
"firstName,lastName,email,companyName,jobTitle,status\nJohn,Doe,john@example.com,Acme Inc,CEO,interested"
Exports entities from a contact list as a downloadable CSV file. The columns included depend on the entity type (contact or company). Use GET /contacts/lists to retrieve valid list IDs (clt_xxx format), then pass the desired ID as the listId query parameter. Set entity to company to export companies instead of contacts.

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Query Parameters

listId
string
required

The contact list ID to export (clt_xxx format), or "all" to export all contacts.

entity
enum<string>
default:contact

The type of entities to export. Defaults to "contact".

Available options:
contact,
company

Response

CSV file download