GET/api/v6/account/billing

Resumen de facturación

Modalidad, moneda y saldo disponible o cupo restante de la organización.

Alcance

API key con la capacidad account concedida

Límite de uso

20 solicitudes por minuto

Devuelve el núcleo de la facturación de la organización dueña de la API key: modalidad (prepago o postpago), moneda, saldo disponible en prepago o cupo restante en postpago. El detalle —topes, pagos y ajustes— vive en /api/v6/account/limits, /api/v6/account/payments y /api/v6/account/adjustments.

El campo available se calcula igual que el motor de gasto en vivo: en prepago balance − consumed; en postpago creditLimit − consumed. Todos los montos son cadenas decimales con 6 decimales, en la currency de la cuenta.

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.

Respuestas

200

Resumen de facturación.

{
  "success": true,
  "data": {
    "account": {
      "id": 10000003,
      "displayName": "Acme S.A.S.",
      "currency": "COP",
      "status": "active"
    },
    "billing": {
      "mode": "prepaid",
      "currency": "COP",
      "period": "2026-06",
      "available": "108500.000000",
      "balance": "108500.000000",
      "consumed": "0.000000",
      "reserve": "0.000000",
      "creditLimit": "0.000000"
    }
  },
  "meta": {
    "requestId": "b9b1704baffab21150213c02fd853975",
    "timestamp": "2026-06-02T19:43:59+00:00",
    "responseTimeMs": 6.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

Respuestas

Errores posibles