GET/v3/live/lists

List person lists

Returns every person list shared with your organization, newest first. Lists a web app user keeps private are not included.

Version: v3
Rate limit: Tier 4 · 10–500 rps by plan
Billing: No entitlement required · List person lists

Request

This endpoint takes no parameters.

Headers: x-api-key Required · API key for authentication

Response

listsobject[]
Every list shared with your organization, newest first.

Status codes

Response

Example

{
  "lists": [
    {
      "id": "3f1c9a2e-7b4d-4e8a-9c61-2d5b8f0e4a17",
      "name": "Q4 target accounts",
      "description": "Decision makers to enrich ahead of Q4 outreach.",
      "memberCount": 1,
      "createdAt": "2026-09-30T14:05:00Z",
      "updatedAt": "2026-09-30T14:05:00Z"
    }
  ]
}