Plan & Abrechnung

Liefert den Vertragszustand (active | deactivated | past_due), ob Schreibzugriffe möglich sind, das laufende Zyklusfenster, den bisherigen Spend der verwalteten Kampagnen, die voraussichtliche Gebühr (min über Stufen) sowie die Tarif-Staffel.

const res = await fetch(`https://api.campaignkit.ventureon.io/v1/plan`, {
    method: "GET",
    headers: {
      Authorization: `Bearer ${process.env.CAMPAIGNKIT_API_KEY}`,
    },
});
const data = await res.json();

{
  "data": {
    "account_status": "active",
    "can_write": true,
    "current_cycle": { "start": "2026-06-18", "end": "2026-07-18" },
    "spend_to_date_cents": 250000,
    "projected": { "tier": "starter", "fix_cents": 9900, "media_fee_cents": 15000, "total_cents": 24900 },
    "last_billed": { "tier": "starter", "total_cents": 24900 },
    "tiers": [
      { "key": "starter", "name": "Starter", "fix_cents": 9900,  "media_fee_pct": 0.06,  "spend_min_cents": 0,       "spend_max_cents": 800000 },
      { "key": "growth",  "name": "Growth",  "fix_cents": 25900, "media_fee_pct": 0.04,  "spend_min_cents": 800000,  "spend_max_cents": 1600000 },
      { "key": "scale",   "name": "Scale",   "fix_cents": 49900, "media_fee_pct": 0.025, "spend_min_cents": 1600000, "spend_max_cents": null }
    ]
  },
  "request_id": "…"
}

Zeigt das laufende Zyklusfenster (am Vertrags-Starttag verankert), den bisher angefallenen Spend der über campaignKit verwalteten Kampagnen und die voraussichtliche Gebühr. KEIN Limit — der Spend wird nie gedeckelt.

const res = await fetch(`https://api.campaignkit.ventureon.io/v1/plan/usage`, {
    method: "GET",
    headers: {
      Authorization: `Bearer ${process.env.CAMPAIGNKIT_API_KEY}`,
    },
});
const data = await res.json();

{
  "data": {
    "cycle_start": "2026-06-18",
    "cycle_end": "2026-07-18",
    "spend_to_date_cents": 250000,
    "projected_tier": "starter",
    "projected_fee_cents": 24900
  },
  "request_id": "…"
}

Deaktiviert das Konto im Selbst-Service: Schreibzugriffe (neue oder aktive Ads) werden gesperrt, Lesen (Status/Insights) bleibt möglich. Der laufende Zyklus wird am Zyklusende noch abgerechnet, danach 0 €, bis ein Admin reaktiviert.

const res = await fetch(`https://api.campaignkit.ventureon.io/v1/account/deactivate`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.CAMPAIGNKIT_API_KEY}`,
      "Idempotency-Key": crypto.randomUUID(),
    },
});
const data = await res.json();

{ "data": { "account_status": "deactivated" }, "request_id": "…" }