Skip to main content
POST
/
v1
/
lists
/
{list_id}
/
export
Export List
curl --request POST \
  --url https://api.example.com/v1/lists/{list_id}/export \
  --header 'Content-Type: application/json' \
  --data '
{
  "fields": [
    {}
  ],
  "anchor": "<string>"
}
'
{
  "data": {
    "export_id": "exp-789",
    "status": "completed",
    "record_count": 45230,
    "download_urls": [
      {
        "filename": "list_export_2026-02-18.csv.gz",
        "url": "https://storage.googleapis.com/...",
        "size": 12345678
      }
    ]
  }
}
Export all items from a completed list. The list must have status "completed" before exporting. Credits are charged by list/search family: property lists charge per property lead even if exported as people, and people lists charge per people lead.
​
list_id
string
required
The list ID to export.
​
fields
array
Data fields to include in the export. If not provided, defaults to address fields.
​
anchor
string
default:"property"
Result anchor type: property or person. Property exports can include contacts that consume people credits; person exports charge per distinct contact.
{
  "data": {
    "export_id": "exp-789",
    "status": "completed",
    "record_count": 45230,
    "download_urls": [
      {
        "filename": "list_export_2026-02-18.csv.gz",
        "url": "https://storage.googleapis.com/...",
        "size": 12345678
      }
    ]
  }
}