List lead lists

GET/lists

Every list, with how many people are in it and the campaigns that take people from it.

Try itSend a real request with your API key

Answer

200 OK Lists.

dataarray of ListRequired
Each item
- idstringRequired
  List ID.
- namestringRequired
- createdAtstring · date-timeRequired
- leadsintegerRequired
  People in the list.
- campaignsarray of objectRequired
  Campaigns that take people from this list.
  Each item
  - idstringRequired
  - namestringRequired
  - statusstringRequired
    draft: not launched. active: running. paused: stopped by the owner. completed: finished. One of draft, active, paused, completed.
nextCursorstring or nullRequired
Pass as cursor for the next page; null on the last page.

Errors

401 Unauthorizedunauthorized
429 Too many requestsrate_limited
500 Server errorserver_error

Every error has the same shape. See Errors.

GET /lists

curl "https://app.salesteam.dev/api/v1/lists" \
  -H "Authorization: Bearer $SALESTEAM_API_KEY"

const response = await fetch("https://app.salesteam.dev/api/v1/lists", {
  headers: {
    Authorization: `Bearer ${process.env.SALESTEAM_API_KEY}`,
  },
});
console.log(response.status, await response.json());

import os
import requests

response = requests.get(
    "https://app.salesteam.dev/api/v1/lists",
    headers={"Authorization": f"Bearer {os.environ['SALESTEAM_API_KEY']}"},
)
print(response.status_code, response.json())

200 answer

{
  "data": [
    {
      "id": "list_7Qm2xT9a",
      "name": "Founders Q4",
      "createdAt": "2026-11-12T09:00:00.000Z",
      "leads": 1,
      "campaigns": [
        {
          "id": "cmp_7Qm2xT9a",
          "name": "Founders Q4",
          "status": "draft"
        }
      ]
    }
  ],
  "nextCursor": null
}