Skip to main content

Endpoint

GET /v1/message-credits/ledger
Escopo necessário: read:message_credits
Este endpoint usa paginação por página (não cursor como os demais). Use os parâmetros page e limit.

Parâmetros de query

ParâmetroTipoDescrição
pageintegerPágina. Padrão: 1
limitintegerItens por página. Padrão: 30. Máximo: 100

Exemplo de requisição

curl "https://api.socialsell.ai/v1/message-credits/ledger?page=1&limit=30" \
  -H "Authorization: Bearer sk_live_..."

Exemplo de resposta

{
  "data": {
    "items": [
      {
        "id": "664o0p1q2r3s4t5u6v7w8x9y",
        "type": "debit",
        "amount_cents": -120,
        "balance_after_cents": 48880,
        "description": "Envio WhatsApp Cloud — template boas_vindas",
        "created_at": "2026-06-10T15:30:00.000Z"
      }
    ],
    "pagination": { "page": 1, "limit": 30, "total": 412, "pages": 14 }
  }
}

Campos do item

CampoTipoDescrição
idstringID do lançamento
typestringdebit (saída) ou credit (entrada)
amount_centsintegerValor em centavos (negativo = débito)
balance_after_centsintegerSaldo após o lançamento
descriptionstringDescrição da operação
created_atstringData/hora do lançamento (ISO 8601)