Skip to main content
GET
/
v1
/
lists
List All Lists
curl --request GET \
  --url https://api.example.com/v1/lists
{
  "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
  }
}
Returns a paginated list of all saved lists for your organization, sorted by most recently updated.
​
page
integer
default:1
Page number.
​
per_page
integer
default:25
Results per page (1-100).
{
  "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
  }
}