> ## 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.

# Get List

> Get list details including build status

Retrieve a single list by its ID. Use this to poll for build completion after creating a list.

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

<ResponseExample>
  ```json 200 Completed theme={null}
  {
    "data": {
      "list_id": "abc-123-def-456",
      "name": "High Value Properties in Miami",
      "source_type": "properties",
      "build_type": "prospect",
      "status": "completed",
      "total_count": 45230,
      "progress": 100,
      "created_at": "2026-02-18T14:30:00Z",
      "updated_at": "2026-02-18T14:30:45Z"
    }
  }
  ```

  ```json 200 Building theme={null}
  {
    "data": {
      "list_id": "abc-123-def-456",
      "name": "High Value Properties in Miami",
      "source_type": "properties",
      "build_type": "prospect",
      "status": "building",
      "total_count": 0,
      "progress": 45,
      "progress_stage": "Staging records...",
      "created_at": "2026-02-18T14:30:00Z",
      "updated_at": "2026-02-18T14:30:15Z"
    }
  }
  ```

  ```json 200 Failed theme={null}
  {
    "data": {
      "list_id": "abc-123-def-456",
      "name": "High Value Properties in Miami",
      "source_type": "properties",
      "status": "error",
      "total_count": 0,
      "progress": 0,
      "error_message": "BigQuery query timed out. Try narrowing your filters.",
      "created_at": "2026-02-18T14:30:00Z",
      "updated_at": "2026-02-18T14:31:00Z"
    }
  }
  ```

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