A simple REST API

Getting started

All requests go to the base URL and send your key along as a Bearer token; the response is always application/json. For each key you decide per resource (forms, submissions) whether it may read or also write — write access is never granted automatically.

Base URL

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

Authentication

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

Create a key in the app under Account → API & integrations. You'll see the full key only once — store it safely. A key grants access to your account's data; you can revoke it at any time. API access is included in the larger packages (see pricing).

Endpoints

Example: fetching submissions

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

Response

{
  "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 & real-time events

Prefer to have the data come to you? Set up webhooks per form: we POST a JSON message to your HTTPS URL whenever something happens — or to a connector like Zapier or Make. A notification for your team is also possible, straight to Slack or Microsoft Teams.

Events to listen for

Every message is signed with HMAC-SHA256; if a delivery fails we retry automatically (backing off up to several hours) and you can see a delivery log per form. The exact payloads, all headers, and ready-to-use verification code (Node.js & Python) are in the interactive documentation.

→ Interactive API documentation  ·  OpenAPI spec (JSON)

Errors & limits

Every key sees only the data of its own account. We never expose your form settings or payment connections via the API — only the field definitions and the submissions.