Saltar al contenido principal
GET

Consultar uso de API (token de automatización)

Scope:developers:usage.read
https://api.holded.com/api/v2/usage

Devuelve 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/json
object
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/json
403Permisos insuficientesapplication/json
429Límite de solicitudes excedidoapplication/json