Docs durchsuchen

Guides und API-Endpunkte durchsuchen

Referenz

Verbrauch

Zeigt die versendeten Mengen: laufender Monat, Hochrechnung, Vormonate. Keine Beträge — abgerechnet wird nach Staffel in Stripe.

Verfügbar
GET

/v1/usage

Gibt die Mengen dieses Kunden zurück: laufender Monat (getrennt nach newsletter/transactional), eine lineare Hochrechnung auf den ganzen Monat und die drei Vormonate. Scope reporting — auch bei gesperrtem Zugang erreichbar.

Request · Next.js

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

Response 200

{
  "data": {
    "current_month": {
      "period_month": "2026-09-01",
      "emails_sent": 12480,
      "emails_newsletter": 9330,
      "emails_transactional": 3150,
      "projected_emails": 41600,
      "days_elapsed": 9,
      "days_in_month": 30
    },
    "previous_months": [
      { "period_month": "2026-08-01", "emails_sent": 38200, "emails_newsletter": 29100, "emails_transactional": 9100 }
    ]
  },
  "request_id": "…"
}

Preise stehen bewusst nicht darin: Was der Verbrauch kostet, rechnet Stripe und stellt es gemeinsam mit den anderen Produkten auf einer Rechnung dar. Eine zweite Stelle mit Beträgen würde irgendwann abweichen.