Statistieken over je hele account, nu in de API

"Hoeveel mails heeft elke klant in maart verstuurd?"

Heb je een platform of een bureau, dan krijg je die vraag elke maand van de administratie. Tot nu toe was het antwoord lastiger dan nodig. De bestaande statistieken in AhaSend worden opgebouwd uit je berichten en gaan dus maar zo ver terug als je bewaartermijn. En een korte bewaartermijn is juist wat je wilt: gegevens over losse berichten hoef je niet langer te bewaren dan nodig.

Met de cijfers ligt dat anders. Die heb je nodig voor facturen, jaarcijfers en rapportages, ook als de berichten zelf allang zijn opgeruimd.

Daarom hebben we die twee losgekoppeld. Het nieuwe endpoint Get Email Statistics geeft de aantallen van je account, of van elk domein apart, over elke periode sinds je account bestaat. Je bewaartermijn speelt daarbij geen rol.

Wat je ermee kunt

E-mail doorbelasten per klant. Met een uitsplitsing per domein krijg je de aantallen van elk verzenddomein per maand. Verstuurt elke klant vanaf een eigen domein, dan heb je daarmee de basis voor je factuur. reception_count is het aantal berichten dat AhaSend heeft aangenomen, en dat is hetzelfde getal waarmee wij factureren. Jouw cijfers en de onze lopen dus gelijk.

Rapporteren zonder zelf te tellen. Veel teams houden via webhooks een eigen teller bij, alleen om te kunnen zeggen wat er vorig kwartaal is verstuurd. Dat hoeft niet meer. De volumes per uur, dag, week of maand haal je met één verzoek op.

Verder terugkijken dan een maand. Vergelijk deze november met die van vorig jaar, of bekijk hoe een domein de afgelopen jaren is gegroeid. Ook domeinen die je hebt verwijderd tellen nog mee.

Wat er wordt geteld

De aantallen gaan over transactionele mail, campagnes en inkomende mail. Inkomende mail telt mee bij het domein dat de mail heeft ontvangen. Sandbox-mail telt niet mee.

Per periode krijg je acht tellers: aangenomen, afgeleverde, gebouncete en onderdrukte berichten, spamklachten, tijdelijke afleverfouten, opens en kliks. De laatste drie tellen gebeurtenissen, dus één bericht kan meer dan één open opleveren. Opens en kliks zijn nooit helemaal nauwkeurig. We doen ons best om bots en scanners eruit te filteren.

Zo werkt het

Vraag de aantallen per maand en per domein op sinds januari:

curl --request GET \
  --url 'https://api.ahasend.com/v2/accounts/{account_id}/statistics/emails?group_by=month&breakdown=domain&from_time=2026-01-01T00:00:00Z&to_time=2026-11-01T00:00:00Z' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Elke rij in data is één domein in één periode:

{
  "from_timestamp": "2026-03-01T00:00:00Z",
  "to_timestamp": "2026-04-01T00:00:00Z",
  "sender_domain": "klant-een.nl",
  "reception_count": 48210,
  "delivered_count": 47655,
  "bounced_count": 498,
  "suppressed_count": 57,
  "complained_count": 3,
  "deferred_count": 1204,
  "opened_count": 0,
  "clicked_count": 0
}

Naast de rijen staat totals, met de aantallen van het hele verzoek. Vaak heb je daar al genoeg aan.

Goed om te weten:

• Periodes zijn in UTC en weken beginnen op maandag.
• Een bereik is maximaal 31 dagen per uur, 366 dagen per dag of week, en 5 jaar per maand.
• Laat je breakdown=domain weg, dan krijg je één rij per periode voor het hele account. Met sender_domain kies je specifieke domeinen.
• De API-sleutel heeft de scope statistics-transactional:read:all nodig, of dezelfde scope voor specifieke domeinen. Een sleutel met domeinscopes ziet alleen die domeinen.

Of vraag het gewoon

Dezelfde statistieken zijn beschikbaar via de AhaSend MCP-server. Koppel die aan je AI-assistent en stel je vraag in gewone taal:

Hoeveel mails heeft elk van onze domeinen dit jaar per maand verstuurd? Zet het in een tabel.

Dat is de maandrapportage voor de administratie, zonder een regel code.

De volledige referentie, met alle parameters en het bladeren door grote uitsplitsingen, staat in de docs.

Begin gratis met AhaSend →