> ## Documentation Index
> Fetch the complete documentation index at: https://api.docs.dealmachine.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Export List

> Export all items from a completed 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.

<ParamField path="list_id" type="string" required>
  The list ID to export.
</ParamField>

<ParamField body="fields" type="array">
  Data fields to include in the export. If not provided, defaults to address fields.
</ParamField>

<ParamField body="anchor" type="string" default="property">
  Result anchor type: `property` or `person`. Property exports can include contacts that consume
  people credits; person exports charge per distinct contact.
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "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
        }
      ]
    }
  }
  ```

  ```json 409 List Not Ready theme={null}
  {
    "error": {
      "code": "list_not_ready",
      "message": "List is still building (72% complete). Try again shortly.",
      "details": {
        "status": "building",
        "progress": 72
      }
    }
  }
  ```

  ```json 404 theme={null}
  {
    "error": {
      "code": "not_found",
      "message": "No list found with ID abc-123"
    }
  }
  ```
</ResponseExample>