Recupera os registros pertencentes a uma audiência previamente gerada, identificada por um list_id.
GET https://segments-xp.wake.tech/v1/lists/{list_id}
Requer um token Bearer válido. (Ver seção Optin / Gerar Token )
Nome Tipo Localização Obrigatório Descrição list_idstring path ✅ ID único da audiência cadastrada para exportação. limitinteger query ❌ Quantidade de itens por página. Padrão: 10. Mínimo: 10, Máximo: 100. pageinteger query ❌ Número da página a ser retornada. Padrão: 1. Mínimo: 1.
HTTP
GET /v1/lists/abc123?limit=20&page=1 HTTP/1.1
Host: https://segments-xp.wake.tech
Authorization: Bearer seu_token_aqui
JSON
{
"total": 2,
"page": 1,
"total_pages": 1,
"success": true,
"limit": 10,
"last_updated": "2025-04-30T14:23:00Z",
"result": [
{
"id": "1a2b3c",
"name": "Maria Silva",
"email": "[email protected] ",
"created_at": "2024-12-10T08:00:00Z"
},
{
"id": "4d5e6f",
"name": "João Oliveira",
"email": "[email protected] ",
"created_at": "2024-12-12T10:15:30Z"
},
]
}
Campo Tipo Descrição totalinteger Total de registros encontrados. pageinteger Página atual. total_pagesinteger Número total de páginas. successboolean Indica se a operação foi bem-sucedida. limitinteger Quantidade de registros por página. last_updatedstring Data/hora da última atualização da lista. resultarray Lista dos registros exportáveis.
Código Descrição 200Requisição bem-sucedida 401Não autorizado 404Audiência não encontrada 422Erro de validação
JSON
{
"detail": [
{
"loc": ["string", 0],
"msg": "string",
"type": "string"
}
]
}
Campo Tipo Descrição locarray Local do parâmetro inválido. msgstring Mensagem descritiva do erro. typestring Tipo do erro de validação.
