Skip to main content
GET
/
api
/
lists
Get Lists
curl --request GET \
  --url https://app.puffle.ai/api/lists \
  --header 'Authorization: Bearer <token>'
{
  "lists": [
    {
      "id": "a1111111-1111-1111-1111-111111111111",
      "name": "all",
      "description": "Every lead in the workspace.",
      "leadType": "mixed",
      "kind": "default",
      "leadCount": 120,
      "personCount": 80,
      "companyCount": 40,
      "createdAt": "2026-04-20T10:00:00Z",
      "updatedAt": "2026-04-20T10:00:00Z"
    },
    {
      "id": "b1111111-1111-1111-1111-111111111111",
      "name": "Series A fintech founders",
      "description": null,
      "leadType": "person",
      "kind": "user",
      "leadCount": 42,
      "personCount": 42,
      "companyCount": 0,
      "createdAt": "2026-04-21T10:00:00Z",
      "updatedAt": "2026-04-22T09:30:00Z"
    }
  ]
}
CLI: 
puffle list
puffle list --id <id>

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
id
string
optional

The ID of the List.

Response

Array of Lists, or one List when id is provided. New users receive the default all List.

​
lists
object[]
required

Every List owned by the caller. The protected default all List is included first.