API-Dokumentation

REST API der FörderNavi-Plattform für Fördermittelkalkulation, Programmsuche, KMU-Klassifizierung, De-minimis-Tracking und Matching.

OpenAPI 3.1REST JSON APIVersion 2.0.0185+ EndpunkteOpenAPI Spec herunterladen

Basis-URL

https://app.foerdernavi.nextgenitsolutions.de/api/v1

Alle API-Anfragen müssen über HTTPS erfolgen. HTTP-Anfragen werden auf HTTPS weitergeleitet. Die OpenAPI 3.1-Spezifikation ist unter /api/v1/openapi als JSON verfügbar.

Rate Limits

Plan	API-Anfragen/Minute	Berechnungen/Monat	Berichte/Monat
Starter	60	100	10
Professional	300	500	50
Enterprise	unbegrenzt	unbegrenzt	unbegrenzt

Bei Überschreitung des Rate Limits wird HTTP 429 zurückgegeben. Die verbleibenden Anfragen und den Reset-Zeitpunkt entnehmen Sie den Antwort-Headern X-RateLimit-Remaining und X-RateLimit-Reset.

Versionierung

Aktuelle Version: v2.0.0 (185+ Endpunkte, 18 Kategorien)

Die API-Version ist Teil des URL-Pfads (/api/v1/...). Veraltete Versionen werden mindestens 12 Monate nach Ankündigung der Nachfolgeversion unterstützt. Breaking Changes werden ausschließlich in neuen Hauptversionen eingeführt. Alle Änderungen sind im -Tab dokumentiert.

Anfrage- und Antwortformat

Anfragen

Content-Type: application/json
Zeichenkodierung: UTF-8
Datumsformat: ISO 8601
Währungsbeträge: immer in EUR (Cent für Stripe)

Antworten

Content-Type: application/json
Fehler enthalten immer ein message-Feld
Paginierte Listen: data + pagination
Zeitstempel: ISO 8601 (UTC)

HTTP-Statuscodes

Code	Bedeutung
200 OK	Anfrage erfolgreich
201 Created	Ressource erfolgreich erstellt
202 Accepted	Anfrage angenommen (asynchrone Verarbeitung läuft)
204 No Content	Anfrage erfolgreich, keine Antwortdaten
400 Bad Request	Ungültige Anfrage oder nicht erlaubter Statusübergang
401 Unauthorized	Authentifizierung fehlt oder ist ungültig
403 Forbidden	Fehlende Berechtigung für diese Ressource
404 Not Found	Ressource nicht gefunden
422 Unprocessable Entity	Validierungsfehler (Details im errors-Objekt)
429 Too Many Requests	Rate Limit überschritten
500 Internal Server Error	Interner Serverfehler (Sentry-ID im requestId-Feld)