Get Usage Summary Endpoint

GET/api/v1/usage/summaryv1 · ESTABLE

GET /api/v1/usage/summary

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.get(
    "https://api.fiscalbridge.cl/api/v1/usage/summary",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Get comprehensive usage summary for current user.

Returns detailed statistics including:

Last 24 hours: Total requests, success rate, failures
Last 7 days: Daily breakdown of API calls
Most used endpoints: Top 10 endpoints by frequency

Authentication: Required (JWT token or API token via X-API-Token)

Rate Limiting: Not rate-limited

Example Response:

{
    "ultimas_24h": {
        "total": 150,
        "exitosas": 145,
        "fallidas": 5,
        "tasa_exito": 96.67
    },
    "ultimos_7_dias": [
        {"fecha": "2025-10-15", "consultas": 180},
        {"fecha": "2025-10-14", "consultas": 165}
    ],
    "endpoints_mas_usados": [
        {"endpoint": "/api/v1/sii/contribuyente", "count": 120},
        {"endpoint": "/api/v1/sii/factura", "count": 30}
    ]
}

Respuestas

200Successful Response

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{
  "data": {
    "endpoints_mas_usados": [
      {}
    ],
    "periodo_actual": {
      "consultas_totales": 0,
      "consultas_usadas": 0,
      "porcentaje_uso": 0
    },
    "ultimas_24h": {
      "consultas_exitosas": 0,
      "consultas_fallidas": 0,
      "tasa_exito": 0,
      "total_consultas": 0
    },
    "ultimos_7_dias": [
      {}
    ]
  },
  "success": true
}

Respuestas

Forma de la respuesta

On this page