v1

latestOpenAPI 3.1.02026-07-2617125852.3 KB

LeadList

List lead list

Requires one of the following scopes: lead_lists:read, lead_lists:all, all:read, all:all

get/api/v2/lead-lists

Query parameters

limitinteger

Example:10

The number of items to return

starting_afterstring

Example:2025-03-07T00:00:00.000Z

The starting after timestamp to filter lead lists by.

has_enrichment_taskboolean

Example:true

Whether the list has an enrichment task.

searchstring

Example:Summer 2025 List

The search query to filter lead lists by.

Response

The list of Lead List

next_starting_afterstring

The filter for getting the next items after this one, this could either be a UUID, a timestamp, on an email depending on the specific API

Example response

{
  "items": [
    {
      "id": "019f94cd-83b9-7ac6-b8b6-f1e45dd95f64",
      "organization_id": "019f94cd-83b9-7ac6-b8b6-f1e5911ffe77",
      "owned_by": "019f94cd-83b9-7ac6-b8b6-f1e6536b18c1",
      "name": "My Lead List",
      "timestamp_created": "2026-07-24T15:45:24.409Z"
    }
  ],
  "next_starting_after": "019f94cd-aeda-7c0b-b338-d3c7eb0b9825"
}