Listar logs de uso

Busca o histórico paginado de requisições do workspace, com filtros.

GEThttps://external-api.lip7.com.br/api/external/usage/logs

Escopowhatsapp:sendSíncrono — responde 200 com os dados

Retorna o histórico de operações feitas pela API, útil para auditoria e para investigar falhas em lote.

Query params

pagenumberopcionalpadrão 1

Número da página.

limitnumberopcionalpadrão 50

Itens por página.

operationTypestringopcional

Filtra pelo tipo de operação.

valoressend_messagesend_templatewebhook_delivery

statusstringopcional

Filtra pelo status da requisição.

valorespendingprocessingsuccessfailed

apiKeyIdstringopcional

Filtra por uma API key específica.

fromstringopcional

Data inicial no formato ISO 8601.

tostringopcional

Data final no formato ISO 8601.

Erros comuns

Código	Causa
`400`	Parâmetro inválido
`401`	API key inválida
`403`	Escopo insuficiente

Requisição

curl -X GET "https://external-api.lip7.com.br/api/external/usage/logs?status=failed&from=2026-06-01" \
  -H "x-api-key: lip_SUA_CHAVE"

const response = await fetch(
  'https://external-api.lip7.com.br/api/external/usage/logs?status=failed&from=2026-06-01',
  { headers: { 'x-api-key': 'lip_SUA_CHAVE' } }
);

const data = await response.json();

Resposta

{
  "success": true,
  "data": {
    "logs": [
      {
        "requestId": "req_...",
        "operationType": "send_message",
        "status": "failed",
        "errorCode": "INVALID_PHONE",
        "enqueuedAt": "2026-06-15T18:00:00.000Z"
      }
    ],
    "total": 1,
    "page": 1,
    "totalPages": 1
  }
}