// docs
Conta e créditos
Endpoints para consultar dados da conta autenticada, saldo atual de créditos e consumo recente em janelas móveis.
Endpoint
GET /v1/me/credits
Base URL
https://api.geckoapi.com.br
Autenticação
Bearer ou X-API-Key
Resposta
JSON
Consultar créditos
Use este endpoint para mostrar o saldo atual da conta e acompanhar créditos consumidos nas últimas 24 horas, 7 dias e 30 dias. A rota aceita o token de sessão do dashboard ou uma API key da GeckoAPI.
GET /v1/me/credits
curl -sS https://api.geckoapi.com.br/v1/me/credits \
-H "Authorization: Bearer pk_live_..."Formato da resposta
currentCredits vem do saldo atual da conta.
creditsConsumed soma créditos efetivamente cobrados
em janelas móveis; chamadas reembolsadas não entram no total consumido.
200 OK
{
"userId": "user-1",
"currentCredits": 123,
"planId": "developer",
"updatedAt": "2026-04-27T12:00:00.000Z",
"creditsConsumed": {
"last24Hours": 7,
"last7Days": 21,
"last30Days": 55
}
}Campos
| Campo | Tipo | Descrição |
|---|---|---|
| currentCredits | number | Saldo disponível no momento da consulta. |
| creditsConsumed.last24Hours | number | Créditos cobrados nas últimas 24 horas. |
| creditsConsumed.last7Days | number | Créditos cobrados nos últimos 7 dias. |
| creditsConsumed.last30Days | number | Créditos cobrados nos últimos 30 dias. |
Grátis para sempre
Quer testar sua conta?
Abra o dashboard para gerar sua API key e consultar o saldo atual da sua conta.