Een eenvoudige REST API

Aan de slag

Alle requests gaan naar de basis-URL en sturen je sleutel mee als Bearer-token. De API is read-only en geeft altijd application/json terug.

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
}

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.