Export List

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.

path list_idstringrequired

The list ID to export.

body fieldsarray

Data fields to include in the export. If not provided, defaults to address fields.

body anchorstringdefault: property

Result anchor type: property or person. Property exports can include contacts that consume people credits; person exports charge per distinct contact.

Response example

1234567891011121314{
  "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
      }
    ]
  }
}

Primary address columns

Contact-list exports can include the person primary-address city, state, and ZIP alongside the existing street fields. Select the field IDs returned by List Fields; request IDs and CSV column aliases can differ. These describe the person's primary address. CSV aliases for these components omit the internal _raw suffix. Use the field catalog to select the address columns you need; this does not change export credit rules.