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

# List All Lists

> List all saved lists for your organization

Returns a paginated list of all saved lists for your organization, sorted by most recently updated.

<ParamField query="page" type="integer" default={1}>
  Page number.
</ParamField>

<ParamField query="per_page" type="integer" default={25}>
  Results per page (1-100).
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "list_id": "abc-123",
        "name": "Miami High Value",
        "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"
      },
      {
        "list_id": "def-456",
        "name": "Vacant Land CA",
        "source_type": "properties",
        "build_type": "prospect",
        "status": "completed",
        "total_count": 12100,
        "progress": 100,
        "created_at": "2026-02-15T10:00:00Z",
        "updated_at": "2026-02-15T10:00:30Z"
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total": 2,
      "has_more": false
    }
  }
  ```
</ResponseExample>
