Skip to main content
GET
/
v1
/
lists
/
{list_id}
Get List
curl --request GET \
  --url https://api.example.com/v1/lists/{list_id}
{
  "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"
  }
}
Retrieve a single list by its ID. Use this to poll for build completion after creating a list.
​
list_id
string
required
The list ID.
{
  "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"
  }
}