List lists

curl --request GET \
  --url https://api.outbound.dev/v1/lists \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.outbound.dev/v1/lists"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.outbound.dev/v1/lists', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "id": "6a1f0c2b9d4e8a7f3c5b2e20",
      "name": "Portugal freight ops",
      "type": "people",
      "rowCount": 42,
      "createdAt": "2026-11-14T10:05:00.000Z",
      "folderId": "6a1f0c2b9d4e8a7f3c5b2e21"
    }
  ],
  "pagination": {
    "pageSize": 50,
    "nextCursor": "Mjo1MA",
    "total": 63
  }
}

{
  "error": {
    "code": "insufficient_balance",
    "message": "Your balance cannot cover this call. Add funds and try again.",
    "doc_url": "https://docs.outbound.dev/errors#insufficient_balance",
    "request_id": "req_6a1f0c2b9d4e8a7f3c5b2e10"
  }
}