GET
Consultar uso de API (token de automatización)
Scope:
developers:usage.readhttps://api.holded.com/api/v2/usageDevuelve el uso de API del mes en curso para el tipo automation_token.
Petición
python
import requests
url = "https://api.holded.com/api/v2/usage"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
response = requests.get(url, headers=headers)
print(response.json())Respuestas
Respuesta
json
{
"type": "automation_token",
"period": "2026-04",
"usage": 12450,
"limit": 25000,
"count": 1,
"secondary_usages": "{\"api_sales_invoices_list\": 150}",
"user_usages": "{\"abc123\": 1500}",
"next_plan": "company_basic",
"next_limit": 300000
}Respuestas exitosas
200Uso de API del mes en cursoapplication/jsonobject
typestringrequired
Usage type identifier
periodstringrequired
Period in YYYY-MM format
usageintegerrequired
Total API calls in this period
limitintegerrequired
Maximum allowed calls for this period
countintegerrequired
Number of usage records aggregated
secondary_usagesobjectrequired
Breakdown by API endpoint type
user_usagesobjectrequired
Token usage aggregated by user id
next_planstring | nullrequired
Next plan with a higher limit, null if already at the top tier
next_limitinteger | nullrequired
Base plan limit for next_plan, null when next_plan is null
Respuestas de error
401API key inválida o no proporcionadaapplication/json403Permisos insuficientesapplication/json429Límite de solicitudes excedidoapplication/json