Get a list

GET/lists/{listId}

One 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

Path

listIdstringRequired
The list.

Answer

200 OK The list.

dataListRequired
Inside it
- 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.

Errors

401 Unauthorizedunauthorized
404 Not foundnot_found not_in_campaign
429 Too many requestsrate_limited
500 Server errorserver_error

Every error has the same shape. See Errors.

GET /lists/{listId}

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

const response = await fetch("https://app.salesteam.dev/api/v1/lists/LIST_ID", {
  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/LIST_ID",
    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"
      }
    ]
  }
}