Skip to main content
GET
/
api
/
lists
/
{id}
/
leads
Get Leads from List
curl --request GET \
  --url https://app.puffle.ai/api/lists/{id}/leads \
  --header 'Authorization: Bearer <token>'
{
  "leads": [
    {
      "id": "<string>",
      "type": "person",
      "name": {
        "full": "<string>",
        "short": "<string>",
        "aliases": [
          "<string>"
        ],
        "first": "<string>",
        "last": "<string>"
      },
      "lists": [
        {
          "id": "<string>",
          "name": "<string>"
        }
      ],
      "sources": [
        {
          "id": "<string>"
        }
      ],
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "location": {
        "city": "<string>",
        "state": "<string>",
        "country": "<string>",
        "raw": "<string>"
      },
      "socials": [
        {
          "url": "<string>"
        }
      ],
      "contacts": [
        {
          "value": "<string>"
        }
      ],
      "attributes": {},
      "raw": {},
      "title": "<string>",
      "company": {
        "name": "<string>",
        "id": "<string>",
        "domain": "<string>"
      }
    }
  ],
  "total": 4503599627370495,
  "hasMore": true,
  "nextCursor": "<string>"
}
CLI:
puffle list lead --id <id>
puffle list lead --id <id> --limit <limit> --cursor <cursor> --type <type>

Overview

Lists leads that belong to a specific list. The response shows the leads in that list while preserving each lead’s identity across the workspace.

AI agent notes

Use this for list-scoped lead paging when you already have a list id. For workspace-wide lead paging or cross-list discovery, use the leads endpoint.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

List UUID.

Minimum string length: 1

Query Parameters

limit
integer
Required range: 1 <= x <= 500
cursor
string
type
enum<string>
Available options:
person,
company

Response

Leads in the List.

leads
object[]
required
total
integer
required
Required range: 0 <= x <= 9007199254740991
hasMore
boolean
required
nextCursor
string | null
required