# Limenia > Limenia is a moderation service for apps under the EU Digital Services Act: app backends send user reports and content for review to its REST API (https://app.limenia.eu/v1), moderators decide in the Limenia dashboard, and Limenia sends each decision with a statement of reasons back to the app backend as a signed webhook. API version 0.33.0. Rules for agents that integrate an app: the API key stays in the app backend (environment variable LIMENIA_API_KEY), never in the mobile or web app, never in logs, and never pasted into a chat. The app talks only to its own backend. Verify every webhook with HMAC-SHA256 over the raw body. Read the developer documentation before writing code; it has one complete path per stack (Flutter with Firebase or Supabase, Node/Express, Go, Python/FastAPI, PHP/Laravel, AWS Lambda). ## Docs - [Developer documentation in one file](https://limenia.eu/docs/integration.md): every page listed below in one Markdown file, in navigation order - [OpenAPI specification](https://limenia.eu/openapi/v1.yaml): the /v1 operations and the webhook events (x-webhooks, schema WebhookEvent) - [Documentation and specification in one file](https://limenia.eu/llms-full.txt) ## Getting started - [Overview](https://limenia.eu/docs/overview/): What Limenia does for your app, how a report becomes a decision, and the hard rules of every integration. - [Quickstart](https://limenia.eu/docs/quickstart/): Set up an app in the dashboard, configure your backend, and send your first report and webhook in a few minutes. - [Concepts](https://limenia.eu/docs/concepts/): The terms of Limenia — tenant, app, API key, user file, content, report, case, decision, complaint, review request, signal, rule, policy, reporter and trusted flagger. - [Choose your path](https://limenia.eu/docs/choose-your-path/): Pick the integration guide for your app and backend, and see the five things every integration does. ## Integration guides - [Flutter with Firebase](https://limenia.eu/docs/guide-firebase/): Complete path for a Flutter app with Firebase Authentication and Cloud Functions as the backend. - [Flutter with Supabase](https://limenia.eu/docs/guide-supabase/): Complete path for a Flutter app with Supabase Auth and Supabase Edge Functions as the backend. - [Node.js with Express](https://limenia.eu/docs/guide-node/): Complete path for a Node.js backend with Express, based on the reference example. - [Go](https://limenia.eu/docs/guide-go/): Complete path for a Go backend with the standard library only. - [Python with FastAPI](https://limenia.eu/docs/guide-python/): Complete path for a Python backend with FastAPI and httpx. - [PHP with Laravel](https://limenia.eu/docs/guide-php/): Complete path for a Laravel 11 backend with drop-in files for the client, the controllers and the webhook. - [AWS Lambda](https://limenia.eu/docs/guide-aws-lambda/): Complete path for a Node.js function on AWS Lambda behind a function URL or API Gateway. - [Any other backend](https://limenia.eu/docs/guide-other/): What to build with any HTTP client and HMAC library when there is no example for your stack. ## API reference - [API basics](https://limenia.eu/docs/api-basics/): Base URL, API keys, versioning, idempotency, errors, rate limits, limits, pagination and timestamps of the /v1 API. - [Reports](https://limenia.eu/docs/reports/): POST /v1/reports — report content or a user, with categories, media handling and how reports become cases. - [Users](https://limenia.eu/docs/subjects/): PUT /v1/subjects/{externalUserId} and GET /v1/subjects/{externalUserId}/status — display names and the sanction status of a user. - [Complaints](https://limenia.eu/docs/appeals/): POST /v1/appeals and GET /v1/appeals/{appealId} — complaints against decisions (Art. 20 DSA), reporters and misuse. - [Pre-moderation reviews](https://limenia.eu/docs/reviews/): POST /v1/reviews and GET /v1/reviews/{reviewId} — have content checked before you publish it. - [Signals](https://limenia.eu/docs/signals/): POST /v1/signals — send observations about users that the tenant's rules turn into cases, priorities or flags. - [Device checks](https://limenia.eu/docs/device-checks/): POST /v1/devices/check — check the device of a user at registration and login with Play Integrity or DeviceCheck. - [Ban evasion across apps](https://limenia.eu/docs/identifiers/): The optional identifiers field — HMACs of e-mail address and phone number that link the user files of a tenant's apps. Coming soon. - [RevenueCat webhook receiver](https://limenia.eu/docs/revenuecat-webhook/): POST /v1/integrations/revenuecat/{tenantId}/{appId} — the endpoint RevenueCat calls; not called by your backend. - [OpenAPI specification](https://limenia.eu/docs/openapi/): The machine-readable description of every /v1 operation and webhook event, and how to use it. ## Webhooks - [Receiving webhooks](https://limenia.eu/docs/webhooks/): How Limenia calls your webhook — headers, signature check with test vector, retries, ordering, applying actions and showing the statement of reasons. - [Webhook events](https://limenia.eu/docs/webhook-events/): Every webhook event with an example payload — decision.created, subject.status_changed, reports.resolved, appeal.resolved, review.decided and test.ping. ## Connectors - [Firebase connector](https://limenia.eu/docs/firebase-connector/): Let Limenia disable and enable Firebase Authentication accounts directly when moderators suspend, ban or restore a user. - [Supabase connector](https://limenia.eu/docs/supabase-connector/): Let Limenia ban and unban Supabase Auth users directly when moderators suspend, ban or restore a user. - [RevenueCat connector](https://limenia.eu/docs/revenuecat-connector/): Let Limenia revoke promotional entitlements and end web subscriptions of banned users, and detect ban evasion through purchase transfers. - [Device connector](https://limenia.eu/docs/device-connector/): Tie bans to devices without fingerprinting, with Play Integrity Device Recall on Android and Apple DeviceCheck on iOS. - [Store reviews](https://limenia.eu/docs/store-reviews/): Collect and answer the reviews of your app in the App Store and Google Play in Limenia — what you set up in App Store Connect, the Play Console and optionally GitHub. ## Compliance - [DSA](https://limenia.eu/docs/dsa/): What the Digital Services Act asks of your app, what Limenia does for you and what remains your job — notice and action, statements of reasons, complaints, trusted flaggers and transparency. - [Data protection](https://limenia.eu/docs/data-protection/): What to send to Limenia and what not, how reporters are pseudonymised, how long data is kept and where it is hosted. ## SDKs and tools - [SDKs and tools](https://limenia.eu/docs/sdks/): Flutter packages limenia and limenia_device, the example backends, typed clients from the OpenAPI spec, llms.txt and the prompt for coding agents. ## Testing and go-live - [Testing](https://limenia.eu/docs/testing/): How to test an integration safely — a test app, self-tests a coding agent can run, the dashboard's webhook test and an end-to-end check. - [Go-live checklist](https://limenia.eu/docs/go-live/): Everything to check before your app goes live with Limenia — setup, reports, webhooks, complaints, optional features and operations. - [Troubleshooting](https://limenia.eu/docs/troubleshooting/): Common errors when integrating Limenia and how to fix them — API answers, webhook signatures, deliveries, connectors and media. - [FAQ](https://limenia.eu/docs/faq/): Short answers to the questions developers ask most when integrating Limenia. - [Changelog](https://limenia.eu/docs/changelog/): Changes of the public API (/v1 and webhook events), newest first. ## Code - [Example backends](https://github.com/DL3KB/limenia-examples): Node/Express, Firebase Cloud Functions, Supabase Edge Functions, AWS Lambda, Go, Python/FastAPI and PHP/Laravel, each with reports, status, device check and a verified webhook receiver (Apache 2.0) - [Flutter package limenia](https://pub.dev/packages/limenia): transport to your own backend, report queue and status, plus ready-made widgets in package:limenia/ui.dart (report sheet, complaint form, statement of reasons, notice for restricted accounts); Flutter 3.35 or newer, pure Dart programs stay on 0.11.x (Apache 2.0) - [Flutter plugin limenia_device](https://pub.dev/packages/limenia_device): optional device token (Play Integrity, DeviceCheck) for the device connector (Apache 2.0) - [Source of both Flutter packages](https://github.com/DL3KB/limenia-flutter) ## Optional - [Limenia website](https://limenia.eu)