# Simple Feedback API

> Simple Feedback collects feedback through QR-code surveys. Its public REST API under `/v1` and its MCP
> server create and manage surveys and read their responses, statistics and AI insights, authenticated with an
> API key sent as `Authorization: Bearer sfk_...`.

The REST API is served at https://simplefeedback.de/api.
API access is a plan feature. Keys are created in the dashboard under Settings → API keys by an owner or
admin of the organization.

## Docs

- [Overview](https://simplefeedback.de/developer/docs/overview.md): What the Simple Feedback API does, the base URL, every REST route with its scope, and the conventions all routes follow, such as paging.
- [Quickstart](https://simplefeedback.de/developer/docs/quickstart.md): Read your survey feedback with a few HTTP calls. Check your API key, find a survey, get its public link and fetch the responses and statistics.
- [Authentication and API keys](https://simplefeedback.de/developer/docs/authentication.md): Create API keys for the Simple Feedback API, choose their scopes, limit them to one venue, and learn when and why a key stops working.
- [Building a survey](https://simplefeedback.de/developer/docs/building-a-survey.md): Create a survey from a short draft, publish it, change its questions and settings, and know which limits apply along the way.
- [Distributing a survey](https://simplefeedback.de/developer/docs/distributing-a-survey.md): Share a Simple Feedback survey as a link or as saved QR codes for print, see scans per location, and know what respondents see before it goes live.
- [Syncing results](https://simplefeedback.de/developer/docs/syncing-results.md): Copy Simple Feedback responses into your own database or BI tool, fetch only new ones on each run, and turn answers back into question texts.
- [QR codes](https://simplefeedback.de/developer/docs/qr-codes.md): List the saved QR codes of an organization, read and compare their scan statistics, point a printed code at another survey, switch it off or delete it.
- [Single-use codes](https://simplefeedback.de/developer/docs/single-use-codes.md): Give each respondent a personal code for exactly one response, on a ticket, receipt or card, and create, print, check and revoke the codes over REST or MCP.
- [Running an integration in production](https://simplefeedback.de/developer/docs/running-in-production.md): Keep a Simple Feedback integration running unattended: keys that outlive people, a startup check, safe retries, errors that need a person, and traceable logs.
- [Connect an AI assistant (MCP)](https://simplefeedback.de/developer/docs/mcp.md): Point Claude, ChatGPT or your own agent at the Simple Feedback MCP server to build surveys and read results, signing in from the assistant or with an API key.
- [Errors](https://simplefeedback.de/developer/docs/errors.md): The error body every Simple Feedback API route returns, every error code it can carry, and what your integration should do with each one.
- [Rate limits](https://simplefeedback.de/developer/docs/rate-limits.md): How many requests a Simple Feedback API key may send per minute, how to read the rate-limit headers, and how to back off after a 429.

## Reference

- [OpenAPI document](https://simplefeedback.de/api/docs-json): every /v1 route, request body, response shape and error code
- [MCP server](https://simplefeedback.de/api/mcp): the same operations as MCP tools over streamable HTTP, same API key
- [All docs in one file](https://simplefeedback.de/llms-full.txt)