Extrato de créditos

GET/credits/transactions

Permissão do token: Ver saldo credits:read

Parâmetros de busca (query)

Parâmetro	Tipo	Obrigatório	Descrição
`limit`	número	Não	Quantos movimentos trazer, de 1 a 200. Padrão: 50.
`offset`	número	Não	Quantos pular, para paginar. Padrão: 0.

Para paginar, some limit ao offset a cada página até vir uma lista menor que o limit.

Resposta

Campo	O que é
`amount`	O valor do movimento. Negativo é saída; positivo é entrada.
`balance_after`	O saldo logo depois deste movimento.
`type`	O tipo do movimento (tabela abaixo).
`reference_type` / `reference_id`	A que o movimento se refere (tabela abaixo).
`notes`	Observação, quando houver.
`created_at`	Quando aconteceu.
`balance`	O seu saldo atual.

`type`	O que é	`reference_id`
`key_generation`	Você gerou keys.	O `generation_id` devolvido na geração.
`refund`	Estorno de uma geração que falhou.	O `generation_id` da geração.
`purchase`	Compra de créditos.	O número do pedido de créditos.
`manual_adjust`	Ajuste feito pela equipe.	—

Erros

HTTP	Quando
`401`	Token ausente, inválido, apagado ou vencido.
`403`	O token não tem a permissão Ver saldo.
`422`	`limit` fora de 1 a 200, ou `offset` negativo.
`429`	Passou do limite de chamadas.

curl -sS "$PROJECT_API_URL/credits/transactions?limit=20" \
  -H "Authorization: Bearer $PROJECT_TOKEN" \
  -H "Accept: application/json"

Resposta · 200

{
  "success": true,
  "message": "Extrato carregado.",
  "data": {
    "transactions": [
      {
        "id": 931,
        "amount": -18,
        "balance_after": 480,
        "type": "key_generation",
        "reference_type": "generation",
        "reference_id": 57,
        "notes": null,
        "created_at": "2026-09-27 21:14:05"
      },
      {
        "id": 930,
        "amount": 200,
        "balance_after": 498,
        "type": "purchase",
        "reference_type": "order",
        "reference_id": 88120,
        "notes": null,
        "created_at": "2026-09-27 20:02:41"
      }
    ],
    "balance": 480
  }
}

Extrato de créditos

Parâmetros de busca (query)Copiar link

RespostaCopiar link

ErrosCopiar link

Parâmetros de busca (query)

Resposta

Erros