De API: waarvoor dient hij en hoe begint u

Wilt u uw cijfers in uw eigen dashboard, in een rapportage of in een monitoringsysteem, dan hoeft u niet te wachten op onze mail. De API geeft dezelfde gegevens terug in JSON.

Wat de API wel en niet doet

• Alleen lezen. Er is geen enkel eindpunt dat iets aanmaakt, wijzigt of verwijdert. Een token dat op straat komt te liggen kan dus niets kapotmaken, wel meelezen.
• Alleen uw eigen gegevens. Elk verzoek wordt beperkt tot het account waar het token bij hoort. Een domein van iemand anders opvragen levert niets op, ook niet als u de naam kent.
• Zit in Pro en hoger. Op een pakket zonder API krijgt u een nette weigering in plaats van gegevens.

Een token aanmaken

Ga naar Instellingen in uw dashboard en maak een API-token aan. U ziet hem één keer: wij bewaren alleen een versleutelde afdruk, zodat niemand hem later kan uitlezen, ook wij niet. Kwijt? Maak een nieuwe aan; de oude vervalt op dat moment.

Uw eerste verzoek

Het token gaat mee als Authorization-kop. Alles loopt over https. Stuurt u per ongeluk over gewoon http, dan weigeren wij het verzoek in plaats van het door te sturen: uw token is dan al onversleuteld over de lijn gegaan en hoort vervangen te worden.

curl -H "Authorization: Bearer dmc_uw_token" \
     https://dmarc-alerts.com/api/v1/domains

Het antwoord is altijd JSON met uw gegevens onder data:

{
  "data": [
    {
      "name": "uwdomein.be",
      "verified": true,
      "policy": "none",
      "reports_count": 128,
      "last_report_at": "2026-09-08T06:12:00+02:00",
      "open_actions": 3,
      "dns_checked_at": "2026-09-09T06:10:00+02:00"
    }
  ]
}

Werkt dit, dan werkt de rest ook. In het artikel over de eindpunten staat wat u verder kunt opvragen.