GET/api/v6/account/usage

Consumo por scope

Consumo del periodo desglosado por organización, centro de costo, usuario, clave y servicio.

Alcance

API key con la capacidad account concedida

Límite de uso

20 solicitudes por minuto

Consumo de la cuenta desglosado por scope (organización, centro de costo, usuario, API key o servicio) para un periodo. El campo total es el consumo de org:0, es decir el gran total. Los montos vienen con 6 decimales.

Información financiera sensible

La API key debe tener habilitada explícitamente la capacidad account. Tener acceso a todos los servicios NO la concede: se otorga aparte, por clave, desde el portal de clientes (Desarrolladores → Claves API). Una key sin la capacidad recibe 403.

Parámetros de consulta

period

stringopcional

Periodo en formato YYYY-MM. Por defecto, el mes en curso.

Respuestas

200

Consumo del periodo.

{
  "success": true,
  "data": {
    "period": "2026-06",
    "total": "108.000000",
    "scopes": [
      { "scopeType": "org", "scopeRef": "0", "consumed": "108.000000" },
      { "scopeType": "cost_center", "scopeRef": "17", "consumed": "108.000000" },
      { "scopeType": "service", "scopeRef": "urlshortener", "consumed": "108.000000" }
    ]
  },
  "meta": {
    "requestId": "b9b1704baffab21150213c02fd853975",
    "timestamp": "2026-06-02T19:43:59+00:00",
    "responseTimeMs": 4.1
  }
}

401

Credenciales inválidas o faltantes.

403

La API key no tiene la capacidad requerida, o la organización no puede ejecutar la solicitud.

429

Se excedió el límite de solicitudes. Espera lo que indique Retry-After.

Errores posibles

Códigos que este endpoint puede devolver en error.code. El detalle completo está en el catálogo.

401AUTH_REQUIREDNo se envió un token Bearer y cada llamada lo requiere.401AUTH_INVALID_KEYLa API key no se reconoce: formato equivocado, revocada o vencida.401AUTH_SERVICE_NOT_ALLOWEDLa key no tiene permitido el servicio detrás de este endpoint.403ACCOUNT_NOT_ACTIVETu organización está suspendida o cerrada.403ACCOUNT_BLOCKEDHay un bloqueo total activo: cada llamada se rechaza.403ACCOUNT_CONFIG_NOT_FOUNDNo pudimos cargar la organización de tu key.403FORBIDDEN403 genérico: alternativa cuando no aplica un `ACCOUNT_*`.429RATE_TPS_EXCEEDEDExcediste el cupo de tu organización para este endpoint.

Ver el catálogo completo

Alcance y límites

Parámetros de consulta

Respuestas

Errores posibles