curl --request GET \
--url 'https://management.scanova.io/plans/current/' \
--header 'Authorization: YOUR_API_KEY'
{
"is_active": true,
"is_free": false,
"expire": "2027-08-16",
"is_expired": false,
"days_left": 365,
"recurring_enabled": false,
"can_cancel_subscription": false,
"payment_method": null,
"pricing": null,
"plan": {
"id": 275,
"slug": "pro-scanova-io",
"name": "Pro - scanova.io",
"plan_type": "Normal",
"description": "...",
"version": 1,
"family": {
"id": 12,
"name": "Pro"
},
"quotas": [
{
"quota_id": 401,
"codename": "QR_CODE_LIMIT",
"name": "QR Code Limit",
"value": 100
}
],
"is_enterprise_plan": false,
"is_custom_plan": false
},
"upcoming_plan": null
}
API de gestión — Analítica y planes
Plan actual
GET /plans/current/
GET
/
plans
/
current
/
curl --request GET \
--url 'https://management.scanova.io/plans/current/' \
--header 'Authorization: YOUR_API_KEY'
{
"is_active": true,
"is_free": false,
"expire": "2027-08-16",
"is_expired": false,
"days_left": 365,
"recurring_enabled": false,
"can_cancel_subscription": false,
"payment_method": null,
"pricing": null,
"plan": {
"id": 275,
"slug": "pro-scanova-io",
"name": "Pro - scanova.io",
"plan_type": "Normal",
"description": "...",
"version": 1,
"family": {
"id": 12,
"name": "Pro"
},
"quotas": [
{
"quota_id": 401,
"codename": "QR_CODE_LIMIT",
"name": "QR Code Limit",
"value": 100
}
],
"is_enterprise_plan": false,
"is_custom_plan": false
},
"upcoming_plan": null
}
Devuelve el plan de suscripción activo de la cuenta autenticada — su caducidad, estado de facturación y el conjunto completo de cuotas/permisos que otorga el plan.
Verificado en vivo contra una cuenta de prueba con plan Pro —
Requiere una clave de la API de gestión con cuota
MANAGEMENT_API (o MANAGEMENT_API_SANDBOX), enviada como el valor sin procesar del encabezado Authorization — consulta el resumen de la API de gestión.Solicitud
curl --request GET \
--url 'https://management.scanova.io/plans/current/' \
--header 'Authorization: YOUR_API_KEY'
{
"is_active": true,
"is_free": false,
"expire": "2027-08-16",
"is_expired": false,
"days_left": 365,
"recurring_enabled": false,
"can_cancel_subscription": false,
"payment_method": null,
"pricing": null,
"plan": {
"id": 275,
"slug": "pro-scanova-io",
"name": "Pro - scanova.io",
"plan_type": "Normal",
"description": "...",
"version": 1,
"family": {
"id": 12,
"name": "Pro"
},
"quotas": [
{
"quota_id": 401,
"codename": "QR_CODE_LIMIT",
"name": "QR Code Limit",
"value": 100
}
],
"is_enterprise_plan": false,
"is_custom_plan": false
},
"upcoming_plan": null
}
pricing y payment_method son null en esta cuenta porque actualmente no está en un ciclo de facturación recurrente de pago; plan.quotas se ha truncado arriba por brevedad (una respuesta real incluye todas las cuotas que otorga el plan).
Campos de la respuesta
boolean
Si el plan está actualmente activo (no caducado, no cancelado).
boolean
Si este es un plan de nivel gratuito.
string
Fecha de caducidad (
YYYY-MM-DD), o la cadena literal "Lifetime" para un plan sin caducidad.boolean
Si el plan ya ha caducado.
integer
Días restantes hasta
expire.boolean
Si la renovación automática está activada.
boolean
Si la cuenta es elegible para cancelar su suscripción desde el panel.
object | null
El método de pago registrado de la cuenta, o
null si no hay ninguno configurado (p. ej. cuentas de Free Trial/aprovisionadas por Enterprise).object | null
El registro específico de precio/periodo de facturación bajo el cual se adquirió este plan (
{id, name, period}, más amount/currency cuando se puede resolver a partir del historial de pedidos), o null si la cuenta no tiene historial de facturación contra este plan.object
La definición del plan en sí.
Mostrar plan properties
Mostrar plan properties
integer
string
string
string
Tipo de plan legible, p. ej.
Normal, Enterprise.string
integer
object
{id, name} — la familia de planes a la que pertenece este plan (p. ej. todos los niveles de “Pro”).array
Todas las cuotas que otorga este plan, cada una como
{quota_id, codename, name, value, ...}. codename es el identificador estable al que hacen referencia los mensajes de error de restricción de cuota de otros endpoints (p. ej. MANAGEMENT_API, FOLDER_MANAGEMENT, EXPORT_ANALYTICS_REPORT).boolean
boolean
object | null
Misma forma que
plan, si la cuenta tiene un cambio de plan programado (p. ej. una degradación que entra en vigor al final del ciclo de facturación actual) — null en caso contrario.El plan Pro canónico no otorga la cuota
MANAGEMENT_API — solo lo hacen los planes Free Trial, Enterprise e Internal en el entorno de prueba verificado. Si estás construyendo contra esta API y obtienes un 401 con "Your plan does not have management API quota.", comprueba aquí plan.quotas para MANAGEMENT_API (o MANAGEMENT_API_SANDBOX) y contacta con soporte si crees que tu plan debería incluirla — no hay una ruta de actualización de autoservicio para esta cuota en particular en este momento.Relacionado
- Resumen de la API de gestión — la asignación de
environmenta cuota (MANAGEMENT_API,INTEGRATION_ZAPIER,INTEGRATION_MCP) a la que corresponden los codenames deplan.quotasde este endpoint. - Crear un token de API — dónde el
environmentde una clave determina cuál de estas cuotas se verifica. - Exportar analíticas — un endpoint restringido por el codename
EXPORT_ANALYTICS_REPORTque puedes comprobar aquí. - Gestión de carpetas — un endpoint restringido por el codename
FOLDER_MANAGEMENTque puedes comprobar aquí.
Autorizaciones
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. management.scanova.io) — the same key sent to the regular API host will not authenticate.
Respuesta
200 - application/json
Current plan detail — expiry, billing state, and the full quota/permission set the plan grants.
¿Esta página le ayudó?
⌘I