Get List

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

path list_idstringrequired

The list ID.

Response example

12345678910111213{
  "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"
  }
}