Uso y saldo de crédito

Última actualización July 20, 2026

Consulta tu uso de la API en lo que va de mes y tu saldo de crédito actual.

TEXT

GET /v1/usage

Requiere una clave de API válida y una membresía activa. A diferencia de los endpoints de búsqueda, este no está condicionado por el crédito —siempre puedes consultar tu saldo, incluso cuando está vacío— y no consume crédito.

Parámetros de consulta

Ninguno.

Respuesta

JSON

{
  "period_start": "2026-06-01T00:00:00Z",
  "requests": 1284,
  "billable_units": 1310,
  "credits": {
    "balance_cents": 4250,
    "balance": 42.50,
    "currency": "usd",
    "included_cents": 0,
    "purchased_cents": 4250,
    "estimated_requests_remaining": 2125,
    "auto_reload_enabled": true
  }
}

Campo	Tipo	Descripción
`period_start`	string (ISO 8601, UTC)	Inicio del periodo de uso del mes natural en curso.
`requests`	integer	Peticiones a la API registradas hasta ahora en este periodo.
`billable_units`	integer	Unidades facturables consumidas en este periodo (una petición puede facturar más de una unidad cuando se despliega en varias obtenciones upstream).
`credits.balance_cents`	integer	Saldo total restante, en unidades menores de la moneda.
`credits.balance`	number	Saldo total restante, en unidades mayores.
`credits.currency`	string	Código de moneda ISO (p. ej. `USD`, `GBP`).
`credits.included_cents`	integer	Saldo restante de la asignación mensual de tu membresía.
`credits.purchased_cents`	integer	Saldo restante del crédito que compraste.
`credits.estimated_requests_remaining`	integer	Número aproximado de peticiones adicionales que cubre tu saldo.
`credits.auto_reload_enabled`	boolean	Si la recarga automática está activada en tu cuenta.

Ejemplos

cURL

curl "https://api.suede.io/v1/usage" \
  -H "Authorization: Bearer $SUEDE_API_KEY"

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new("Bearer", Environment.GetEnvironmentVariable("SUEDE_API_KEY"));
var json = await http.GetStringAsync("https://api.suede.io/v1/usage");
Console.WriteLine(json);

JavaScript

const res = await fetch("https://api.suede.io/v1/usage", {
  headers: { Authorization: `Bearer ${process.env.SUEDE_API_KEY}` },
});
const usage = await res.json();
console.log(`Balance: ${usage.credits.balance} ${usage.credits.currency}`);

El mismo saldo se devuelve en cada respuesta facturable mediante las cabeceras X-Credits-Balance y X-Credits-Requests-Remaining; consulta Errores.