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
}
Management-API — Analysen & Tarife
Aktueller Plan
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
}
Gibt den aktiven Abonnementplan des authentifizierten Kontos zurück — sein Ablaufdatum, den Abrechnungsstatus und die vollständige Menge an Quoten/Berechtigungen, die der Plan gewährt.
Live gegen ein Test-Konto mit Pro-Plan verifiziert —
Erfordert einen Management-API-Schlüssel mit
MANAGEMENT_API- (oder MANAGEMENT_API_SANDBOX-)Quota, gesendet als roher Authorization-Header-Wert — siehe die Management-API-Übersicht.Anfrage
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 und payment_method sind bei diesem Konto null, da es sich derzeit nicht in einem bezahlten, wiederkehrenden Abrechnungszyklus befindet; plan.quotas ist oben aus Gründen der Kürze gekürzt (eine echte Antwort enthält jede Quota, die der Plan gewährt).
Antwortfelder
boolean
Ob der Plan derzeit aktiv ist (nicht abgelaufen, nicht gekündigt).
boolean
Ob es sich um einen kostenlosen Plan handelt.
string
Ablaufdatum (
YYYY-MM-DD), oder der wörtliche String "Lifetime" für einen Plan ohne Ablaufdatum.boolean
Ob der Plan bereits abgelaufen ist.
integer
Verbleibende Tage bis
expire.boolean
Ob die automatische Verlängerung aktiviert ist.
boolean
Ob das Konto berechtigt ist, sein Abonnement über das Dashboard zu kündigen.
object | null
Die hinterlegte Zahlungsmethode des Kontos, oder
null, falls keine festgelegt ist (z. B. bei Free-Trial-/Enterprise-bereitgestellten Konten).object | null
Der konkrete Preis-/Abrechnungszeitraum-Datensatz, unter dem dieser Plan erworben wurde (
{id, name, period}, plus amount/currency, sofern aus dem Bestellverlauf ermittelbar), oder null, falls das Konto keine Abrechnungshistorie zu diesem Plan hat.object
Die Plandefinition selbst.
Anzeigen plan properties
Anzeigen plan properties
integer
string
string
string
Für Menschen lesbarer Plantyp, z. B.
Normal, Enterprise.string
integer
object
{id, name} — die Plan-Familie, zu der dieser Plan gehört (z. B. alle Stufen von “Pro”).array
Jede Quota, die dieser Plan gewährt, jeweils als
{quota_id, codename, name, value, ...}. codename ist der stabile Bezeichner, auf den sich die Quota-Sperr-Fehlermeldungen anderer Endpunkte beziehen (z. B. MANAGEMENT_API, FOLDER_MANAGEMENT, EXPORT_ANALYTICS_REPORT).boolean
boolean
object | null
Dieselbe Form wie
plan, falls das Konto eine geplante Planänderung hat (z. B. ein Downgrade, das am Ende des aktuellen Abrechnungszyklus wirksam wird) — sonst null.Der kanonische Pro-Plan gewährt keine
MANAGEMENT_API-Quota — nur Free Trial, Enterprise und Internal-Pläne tun dies in der verifizierten Testumgebung. Wenn Sie gegen diese API entwickeln und einen 401-Fehler mit "Your plan does not have management API quota." erhalten, prüfen Sie plan.quotas hier auf MANAGEMENT_API (oder MANAGEMENT_API_SANDBOX) und kontaktieren Sie den Support, falls Sie glauben, dass Ihr Plan dies enthalten sollte — für diese spezielle Quota gibt es derzeit keinen Self-Service-Upgrade-Pfad.Verwandte Themen
- Management-API-Übersicht — die
environment-zu-Quota-Zuordnung (MANAGEMENT_API,INTEGRATION_ZAPIER,INTEGRATION_MCP), der dieplan.quotas-Codenames dieses Endpunkts entsprechen. - Ein API-Token erstellen — wo das
environmenteines Schlüssels bestimmt, welche dieser Quoten geprüft wird. - Analysen exportieren — ein durch den
EXPORT_ANALYTICS_REPORT-Codenamen gesperrter Endpunkt, den Sie hier prüfen können. - Ordnerverwaltung — ein durch den
FOLDER_MANAGEMENT-Codenamen gesperrter Endpunkt, den Sie hier prüfen können.
Autorisierungen
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.
Antwort
200 - application/json
Current plan detail — expiry, billing state, and the full quota/permission set the plan grants.
War diese Seite hilfreich?
⌘I