INinstantly
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

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/lead-lists
  • Auth
    HTTP bearer

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": "01a19e6d-60b7-7762-a3a7-2a7044278c4d",
      "organization_id": "01a19e6d-60b7-7762-a3a7-2a713c607109",
      "owned_by": "01a19e6d-60b7-7762-a3a7-2a7287c3147c",
      "name": "My Lead List",
      "timestamp_created": "2026-11-02T22:42:10.743Z"
    }
  ],
  "next_starting_after": "01a19e6d-b02c-7da7-9f91-6dba1d322ed0"
}

Changes

No recorded changes to this operation across all 5 revisions of this API.