Buscar lista por ID - Vistum CRM

curl "https://crm.vistum.com.br/api/v1/lists/list_bf01" \
  -H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI"

{
  "data": {
    "id": "list_bf01",
    "name": "Black Friday 2026",
    "contactCount": 342,
    "createdAt": "2026-07-01T10:00:00.000Z",
    "contacts": [
      { "id": "cnt_a", "name": "João Ferreira", "phone": "5511999887766" }
    ]
  },
  "pagination": { "total": 342, "limit": 25, "offset": 0, "hasMore": true }
}

GET

api

lists

{id}

curl "https://crm.vistum.com.br/api/v1/lists/list_bf01" \
  -H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI"

{
  "data": {
    "id": "list_bf01",
    "name": "Black Friday 2026",
    "contactCount": 342,
    "createdAt": "2026-07-01T10:00:00.000Z",
    "contacts": [
      { "id": "cnt_a", "name": "João Ferreira", "phone": "5511999887766" }
    ]
  },
  "pagination": { "total": 342, "limit": 25, "offset": 0, "hasMore": true }
}

Autenticação

string

required

Bearer vg_live_<sua_chave> — API Key com escopo lists:read

Retorna a lista + seus contatos paginados (limit/offset aplicam aos contatos).

curl "https://crm.vistum.com.br/api/v1/lists/list_bf01" \
  -H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI"

{
  "data": {
    "id": "list_bf01",
    "name": "Black Friday 2026",
    "contactCount": 342,
    "createdAt": "2026-07-01T10:00:00.000Z",
    "contacts": [
      { "id": "cnt_a", "name": "João Ferreira", "phone": "5511999887766" }
    ]
  },
  "pagination": { "total": 342, "limit": 25, "offset": 0, "hasMore": true }
}

​Autenticação

Autenticação