Skip to main content
GET
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.
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

Live gegen ein Test-Konto mit Pro-Plan verifiziert — 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.
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 die plan.quotas-Codenames dieses Endpunkts entsprechen.
  • Ein API-Token erstellen — wo das environment eines 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

Authorization
string
header
erforderlich

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.