INinstantly
LeadList

Get lead list

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

get/api/v2/lead-lists/{id}

Request

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

Path parameters

idstring uuid required
Example:01a19e6e-66a6-7c2e-a575-7e1e6f474b1e

The ID of the requested item

Response

The requested Lead List

idstring uuid required

Unique identifier for the lead list

organization_idstring uuid required

Organization ID that owns this lead list

has_enrichment_taskboolean nullable

Whether this list runs the enrichment process on every added lead or not

owned_bystring uuid nullable

User ID of the owner of this lead list. Defaults to the user that created the list

namestring required

Name of the lead list

timestamp_createdstring date-time required

Timestamp when the lead list was created

Example response

{
  "id": "01a19e6e-2793-7fe0-a813-56b3edb3ac24",
  "organization_id": "01a19e6e-2793-7fe0-a813-56b48164c29a",
  "owned_by": "01a19e6e-2793-7fe0-a813-56b5ccb14c2e",
  "name": "My Lead List",
  "timestamp_created": "2026-11-02T22:43:01.651Z"
}

Changes

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