Feedback Analytics API

Intro

One REST API for everything: fetch workspaces and forms (including schema and analytics), get form responses (with answers, score, datatable link), manage datatables (CRUD on rows), email history and events. API key authentication. Suitable for Zapier, Make, n8n and your own apps.

Quick start

curl https://feedback-analytics.com/api/v1/workspaces \
  -H "X-API-Key: YOUR_API_KEY"

{
  "data": [
    {
      "id": "ws_123",
      "name": "Main workspace",
      "link": "my-workspace"
    }
  ],
  "meta": {},
  "links": {},
  "request_id": "req_abc123"
}

Authentication

Send the X-API-Key header with your API key with every request. Keys start with fa_. Your API key has access to one or more workspaces; you may only request resources from those workspaces.

Create an API key in Workspace settings → API keys (after login). Keep your key safe and never share it in frontend code or public repos.

curl "https://feedback-analytics.com/api/v1/workspaces" \
  -H "X-API-Key: fa_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Response format

Elke succes-response heeft exact vier top-level velden. Errors hebben error en request_id.

{
  "data": {},
  "meta": {},
  "links": {},
  "request_id": "req_abc123"
}

Error codes

On error the API returns JSON with error, message and optionally details.

{
  "error": {
    "code": "resource_not_found",
    "message": "Resource not found",
    "status": 404
  },
  "request_id": "req_abc123"
}

Error codes

Pagination

Cursor-based: gebruik limit (standaard 20, max 100) en cursor voor de volgende pagina. Gebruik links.next voor de volgende URL.

curl "https://feedback-analytics.com/api/v1/workspaces/WORKSPACE_ID/responses?limit=20&cursor=resp_123" \
  -H "X-API-Key: YOUR_API_KEY"

• • default limit = 20, max limit = 100
• • cursor-based; geen page/offset
• • meta.has_more geeft aan of er meer pagina's zijn

Filtering & sort

Query parameters per resource. Veelvoorkomend: form_id, created_after, created_before, score_gte, score_lte. Sort: sort=veld:richting (asc of desc).

curl "https://feedback-analytics.com/api/v1/workspaces/WORKSPACE_ID/responses?form_id=form_123&limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://feedback-analytics.com/api/v1/workspaces/WORKSPACE_ID/responses?created_after=2026-01-01&score_gte=8" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://feedback-analytics.com/api/v1/workspaces/WORKSPACE_ID/responses?sort=created_at:desc" \
  -H "X-API-Key: YOUR_API_KEY"

Resources

Alle endpoints zijn genest onder /api/v1/workspaces/{workspace_id}. Vervang workspace_id met de id uit GET /workspaces.

Workspaces

Workspaces die de API-key kan benaderen. Gebruik de id als workspace_id in alle andere endpoints.

curl "https://feedback-analytics.com/api/v1/workspaces" -H "X-API-Key: YOUR_API_KEY"

Forms

You can fetch forms in a workspace (list and details), get the form schema (questions, types, options, validation; useful for integrations) and an analytics summary (total responses, average score, last response). The schema endpoint supports If-None-Match / ETag for caching. See the overview below and the OpenAPI specification for all parameters.

Questions

Vragen horen bij een formulier. Alleen lezen in v1.

Responses

Fetch form responses: list with pagination, filter and sort, or a single response by ID. Each response includes answers, score, link to form and datatable (row_id). When someone filled the form via an email link, you get respondent_email and email_id. With include_table_data=true you get the datatable row as it was at submit time. Ideal for reporting, CRM sync or your own dashboards.

Veelgebruikte filters

form_id, created_after, created_before, score_gte, score_lte

curl "https://feedback-analytics.com/api/v1/workspaces/WORKSPACE_ID/responses?form_id=form_123&limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "data": [
    {
      "id": "resp_123",
      "form_id": "form_123",
      "score": 8,
      "created_at": "2026-03-10T12:00:00Z",
      "answers": [],
      "respondent_email": null,
      "row_id": null
    }
  ],
  "meta": { "limit": 20, "has_more": false },
  "links": { "self": "...", "next": null, "prev": null },
  "request_id": "req_abc123"
}

Datatables

Manage rows in your datatables: list tables, fetch fields, read rows with filter and sort, add or update one or more rows (upsert on data.id), or delete.

Rows (datatable-rijen)

CRUD op rijen binnen een datatable. Server wijst row_id toe bij POST. PATCH voor partiële update, DELETE voor verwijderen.

curl -X POST "https://feedback-analytics.com/api/v1/workspaces/WORKSPACE_ID/datatables/DATATABLE_ID/rows" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data": {"email": "jan@voorbeeld.nl", "naam": "Jan"}}'

{
  "data": {
    "row_id": "row_abc",
    "email": "jan@voorbeeld.nl",
    "naam": "Jan",
    "created_at": "2026-03-10T12:00:00Z",
    "updated_at": "2026-03-10T12:00:00Z"
  },
  "meta": {},
  "links": {},
  "request_id": "req_abc123"
}

Email events

Fetch email event history: sends, opens, clicks, bounces, etc. linked to email_id, row_id, form_id and flow_id. Useful for reporting or CRM sync.

Filters: email_id, type, created_after, created_before, recipient

curl "https://feedback-analytics.com/api/v1/workspaces/WORKSPACE_ID/email-events?limit=20&sort=created_at:desc" \
  -H "X-API-Key: YOUR_API_KEY"

Webhook endpoints

Beheer webhook-URLs voor events. POST om aan te maken, DELETE om te verwijderen.

API keys

Lijst metadata van API-keys (geen secrets). POST om een key aan te maken; de secret wordt één keer getoond. DELETE om te revoken.

Rate limit

There is a rate limit per API key (about 60 requests per minute). The response headers X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset show your current usage.

Elke response bevat de headers X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (Unix seconden).

OpenAPI specification

De machine-readable OpenAPI 3.0-spec kun je gebruiken voor client generation, Postman/Insomnia import, tooling en SDK-generation.

This documentation follows the implementation spec docs/API-ARCHITECTURE-DESIGN.md. Endpoint matrix: docs/API-ENDPOINT-MATRIX.md. Gap analysis: docs/API-GAP-ANALYSIS.md. OpenAPI: GET /api/v1/openapi. Pagination: cursor + limit (default 20, max 100).