Referencia
Estado de cuenta
Consultá cuotas, límites y API keys asociadas al owner.
API v1AnteriorGET
/v1/statusRetorna el uso de cuotas a nivel owner y todas las API keys asociadas. En Custom incluye el estimado ARS de Basic + Reportes y, por separado, consumo de módulos en la moneda del período. Basic y módulos comparten consumo entre V1/V2; sharedUsage muestra el detalle por versión.
- Autenticación
x-api-key- Consumo
- Sin consumo de cuota del plan
- Planes
- free · starter · growth · scale · custom
Request
Ejecutá este ejemplo desde tu servidor o terminal. Usá tu key en la variable CLASIFICAR_API_KEY.
Terminal
curl "https://api.clasific.ar/v1/status" \
-H "x-api-key: $CLASIFICAR_API_KEY"TypeScript · servidor
const apiKey = process.env.CLASIFICAR_API_KEY;
if (!apiKey) throw new Error("Falta CLASIFICAR_API_KEY");
const response = await fetch(
"https://api.clasific.ar/v1/status",
{
headers: {
"x-api-key": apiKey,
},
},
);
if (!response.ok) {
throw new Error(
`HTTP ${response.status}: ${await response.text()}`,
);
}
const result: unknown = await response.json();
console.log(result);Parámetros
No requiere parámetros ni un body JSON.
Respuesta
200 Ejemplo de respuesta. Los valores corresponden a datos ilustrativos del contrato V1.
Response · JSON
{
"success": true,
"data": {
"owner": "user_martin",
"plan": "custom",
"usage": {
"fast": {
"used": 42,
"limit": 100
},
"intelligent": {
"used": 2,
"limit": 5
},
"miss": {
"used": 8,
"limit": 500
}
},
"rateLimits": {
"rpm_total": 60,
"rpm_intelligent": 5
},
"resetAt": "2026-02-23T00:00:00.000Z",
"customBilling": {
"contract": {
"status": "active"
},
"period": {
"key": "2026-08",
"start": "2026-08-01",
"end": "2026-09-01"
},
"usage": {
"basic": {
"used": 43,
"limit": 10000,
"remaining": 9957
},
"report": {
"used": 0,
"limit": 10,
"remaining": 10
},
"modules": {
"used": 2004,
"limit": 2000,
"remaining": 0,
"overage": 4,
"subtotal_cents": 300,
"currency": "USD"
}
},
"billing": {
"base": {
"estimated_total_cents": 249400,
"currency": "ARS",
"pricing_mode": "automatic",
"tier_name": "Basic"
},
"modules": {
"estimated_overage_cents": 300,
"currency": "USD"
}
}
},
"keys": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"prefix": "clk_AbCd",
"last4": "xYzW",
"name": "Production Key",
"status": "active",
"lastUsedAt": "2026-02-22T21:15:00.000Z",
"createdAt": "2026-02-01T10:00:00.000Z"
}
]
}
}Errores
Comprobá el estado HTTP antes de procesar el resultado. Los formatos de error pueden variar por endpoint. Consultá errores y rate limits para gestionar errores de acceso y capacidad.