Export lists as CSV

Exports one list as a CSV file, or several lists as a ZIP archive with one CSV per list.

CSV format: UTF-8 with BOM, comma separator, CRLF line endings. Columns: First Name, Last Name, Full Name, Email, Phone, Mobile Phone, Job Title, LinkedIn URL, Bio, Company, Website, LinkedIn Page, Company Size, Industry, Country, Region, City, Status, Handle, then one column per custom variable of the account (display name), then Lists and Campaigns (one Campaign name - STATUS line per campaign). Company-only lists use a shorter header (Company, Website, LinkedIn Page, Company Size, Industry, custom variables, Lists).

leadIds, search, statuses and filters only apply when exactly one list is exported; they are ignored for a multi-list ZIP. List ids that are not yours are silently skipped.

Large exports: send async: true. If the export covers more than 5,000 contacts, the response is 202 with a jobId: poll GET /lists/list/export/jobs/{jobId} until status is done, then download the file. At or under 5,000 contacts the file is returned directly (200) even with async: true, so handle both responses. With async: true, an export above 100,000 contacts is refused (422). Only one asynchronous export runs per account: while one is queued or running, a new request returns that existing job (it may concern other lists). Without async, the file is always streamed synchronously, whatever its size, and the connection may be cut after 120 seconds of silence.

Response BodyCopy Anchor Link