Een eenvoudige REST API

Aan de slag

Alle requests gaan naar de basis-URL en sturen je sleutel mee als Bearer-token; het antwoord is altijd application/json. Per sleutel bepaal je per onderdeel (formulieren, inzendingen) of die mag lezen of ook mag schrijven — schrijfrechten worden nooit automatisch verleend.

Basis-URL

https://app.formuliermet.nl/api/v1

Authenticatie

curl https://app.formuliermet.nl/api/v1/me \
  -H "Authorization: Bearer fmb_je_sleutel_hier"

Maak een sleutel aan in de app onder Account → API & koppelingen. Je ziet de volledige sleutel maar één keer — bewaar 'm veilig. Een sleutel geeft toegang tot de gegevens van jouw account; je kunt 'm op elk moment intrekken. API-toegang zit in de grotere pakketten (zie tarieven).

Endpoints

Voorbeeld: inzendingen ophalen

curl "https://app.formuliermet.nl/api/v1/forms/FORM_ID/submissions?limit=2" \
  -H "Authorization: Bearer fmb_je_sleutel_hier"

Antwoord

{
  "data": [
    {
      "id": "ckv8s2...",
      "formId": "ckv7a1...",
      "sequenceNumber": 42,
      "status": "paid",
      "amountCents": 2500,
      "email": "deelnemer@example.com",
      "paymentMethod": "ideal",
      "createdAt": "2026-06-01T14:30:00.000Z",
      "updatedAt": null,
      "data": { "naam": "Jan Jansen", "aantal": 2 }
    }
  ],
  "page": 1,
  "limit": 2,
  "total": 42
}

Webhooks & realtime events

Liever dat de gegevens naar jóú toe komen? Stel per formulier webhooks in: wij POST'en een JSON-bericht naar jouw HTTPS-URL zodra er iets gebeurt — of naar een koppelaar als Zapier of Make. Een melding in je team kan ook, rechtstreeks naar Slack of Microsoft Teams.

Gebeurtenissen om op mee te luisteren

Elk bericht is ondertekend met HMAC-SHA256, bij een storing proberen we het automatisch opnieuw (oplopend tot enkele uren) en je ziet per formulier een afleverlog. De exacte payloads, alle headers en kant-en-klare verificatiecode (Node.js & Python) staan in de interactieve documentatie.

→ Interactieve API-documentatie  ·  OpenAPI-spec (JSON)

Fouten & limieten

Elke sleutel ziet uitsluitend de gegevens van het eigen account. We tonen nooit je formulierinstellingen of betaalkoppelingen via de API — alleen de velddefinities en de inzendingen.