Menu

Förderprogramme

Endpoint: Förderprogramme

Die Grants-Endpoints ermöglichen den Zugriff auf Förderprogramme innerhalb deines zugewiesenen Scopes (Regionen und Förderthemen).

GET /api/v1/grants

Listet Förderprogramme mit optionalen Filtern.

Scope erforderlich: grants:read

Query-Parameter

Parameter Typ Beschreibung
region_ids[] Array Filter nach Region-IDs (muss im Partner-Scope sein)
grant_area_ids[] Array Filter nach Förderthemen-IDs (muss im Partner-Scope sein)
grant_provider_id UUID Filter nach Fördergeber-ID
q String Volltextsuche in Titel und Beschreibung
grant_type String Förderart: subsidy, loan, guarantee, equity
page Integer Seitennummer (Standard: 1)
per_page Integer Ergebnisse pro Seite (Standard: 25, Max: 100)

Beispiel-Request

curl -X GET "https://foerdermittelkompass.reflecta.org/api/v1/grants?page=1&per_page=25&q=kultur" \
  -H "Authorization: Bearer rfk_dein_token" \
  -H "Content-Type: application/json"

Beispiel-Response

{
  "grants": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "slug": "kulturfoerderung-bayern",
      "title": "Kulturförderung Bayern",
      "short_description": "Förderung kultureller Projekte in Bayern",
      "grant_type": "subsidy",
      "grant_provider": {
        "id": "...",
        "name": "Bayerisches Staatsministerium für Wissenschaft und Kunst"
      },
      "end_date": "2026-03-31",
      "ongoing_grant": false,
      "funding_amount": "5.000 - 100.000 EUR",
      "max_funding_amount": 100000,
      "regions": [
        {
          "id": "...",
          "name": "Bayern"
        }
      ],
      "grant_areas": [
        {
          "id": "...",
          "name": "Kultur"
        }
      ],
      "target_groups": [
        {
          "id": "...",
          "name": "Kinder & Jugendliche"
        }
      ],
      "updated_at": "2026-01-15T10:30:00Z",
      "ai_qualified": true,
      "ai_qualification_reasoning": "Die Förderung richtet sich an gemeinnützige Kulturvereine und passt zu den Kriterien des Partners.",
      "custom_categories": [
        { "id": "...", "name": "Bildende Kunst", "name_en": "Visual Arts" },
        { "id": "...", "name": "Kulturvermittlung", "name_en": "Cultural Education" }
      ]
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 5,
    "total_count": 112,
    "per_page": 25
  }
}

GET /api/v1/grants/:id

Ruft Details eines einzelnen Förderprogramms ab.

Scope erforderlich: grants:read

Path-Parameter

Parameter Typ Beschreibung
id UUID oder String Grant-ID (UUID) oder Slug

Beispiel-Request

# Mit UUID
curl -X GET "https://foerdermittelkompass.reflecta.org/api/v1/grants/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer rfk_dein_token"

# Mit Slug
curl -X GET "https://foerdermittelkompass.reflecta.org/api/v1/grants/kulturfoerderung-bayern" \
  -H "Authorization: Bearer rfk_dein_token"

Beispiel-Response

{
  "grant": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "slug": "kulturfoerderung-bayern",
    "title": "Kulturförderung Bayern",
    "short_description": "Förderung kultureller Projekte in Bayern",
    "description": "Das Programm unterstützt kulturelle Projekte...",
    "grant_type": "subsidy",
    "grant_provider": {
      "id": "...",
      "name": "Bayerisches Staatsministerium für Wissenschaft und Kunst",
      "slug": "bayerisches-staatsministerium",
      "grant_provider_type": "government",
      "website": "https://www.stmwk.bayern.de",
      "email": "[email protected]",
      "phone": "+49 89 12345678",
      "address": {
        "street_and_number": "Salvatorstraße 2",
        "postal_code": "80333",
        "city": "München",
        "state": "Bayern",
        "country": "Deutschland"
      }
    },
    "contact_point": null,
    "start_date": "2026-01-01",
    "end_date": "2026-03-31",
    "end_date_description": "Anträge können bis zum 31.03.2026 eingereicht werden",
    "ongoing_grant": false,
    "earliest_project_start": "2026-04-01",
    "project_duration": "12-24 Monate",
    "funding_amount": "5.000 - 100.000 EUR",
    "max_funding_amount": 100000,
    "funding_rate": "bis zu 80%",
    "funding_goal": "Förderung kultureller Projekte",
    "eligibility_requirements": ["Sitz in Bayern", "Gemeinnützigkeit"],
    "target_group_description": "Kulturvereine und -institutionen",
    "non_profit_only": true,
    "company_size": null,
    "eligible_entities": [
      { "id": "...", "name": "Eingetragener Verein" },
      { "id": "...", "name": "Stiftung" }
    ],
    "target_groups": [
      { "id": "...", "name": "Kinder & Jugendliche" },
      { "id": "...", "name": "Ehrenamtliche" }
    ],
    "eligible_expenditures": ["Personalkosten", "Sachkosten"],
    "non_eligible_expenditures": ["Baumaßnahmen"],
    "eligible_expenditure_categories": ["personal", "material"],
    "evaluation_criteria": ["Projektqualität", "Nachhaltigkeit"],
    "documents_needed": ["Vereinssatzung", "Freistellungsbescheid"],
    "application_level": "level_medium",
    "application_links": ["https://..."],
    "guideline_links": ["https://..."],
    "reporting_and_claims_links": ["https://..."],
    "regions": [
      { "id": "...", "name": "Bayern", "region_type": "state" }
    ],
    "grant_areas": [
      { "id": "...", "name": "Kultur", "parent_id": "..." }
    ],
    "created_at": "2025-06-01T08:00:00Z",
    "updated_at": "2026-01-15T10:30:00Z",
    "ai_qualified": true,
    "ai_qualification_reasoning": "Die Förderung richtet sich an gemeinnützige Kulturvereine und passt zu den Kriterien des Partners.",
    "custom_categories": [
      { "id": "...", "name": "Bildende Kunst", "name_en": "Visual Arts" },
      { "id": "...", "name": "Kulturvermittlung", "name_en": "Cultural Education" }
    ]
  }
}

Für eine vollständige Feldbeschreibung siehe Felderliste.

Scope-Einschränkungen

Die API liefert nur Förderprogramme innerhalb deines zugewiesenen Scopes:

  • Wurden dir bestimmte Regionen zugewiesen, siehst du nur Programme in diesen Regionen
  • Wurden dir bestimmte Förderthemen zugewiesen, siehst du nur Programme in diesen Bereichen
  • Filter-Parameter müssen ebenfalls im Scope liegen

Versuche, Grants außerhalb deines Scopes abzurufen, führen zu 404-Fehlern.

KI-Qualifizierung

Wenn für deinen API-Partner ein KI-Qualifizierungsprompt konfiguriert ist, werden alle Förderungen in deinem Scope durch KI bewertet. Das Ergebnis wird in zwei zusätzlichen Feldern zurückgegeben:

Feld Typ Beschreibung
ai_qualified Boolean/null true = Förderung passt zu deinen Kriterien, false = passt nicht, null = noch nicht bewertet
ai_qualification_reasoning String/null Begründung der KI (2-3 Sätze). null wenn noch nicht bewertet.

Wichtig: Alle Förderungen werden unabhängig vom Qualifizierungsergebnis zurückgegeben. Die Felder dienen zur Priorisierung und Filterung auf deiner Seite.

Beispiel für eine qualifizierte Förderung: json { "ai_qualified": true, "ai_qualification_reasoning": "Die Förderung richtet sich an gemeinnützige Organisationen im Bereich Bildung und erfüllt die Kriterien des Partners." }

Beispiel für eine nicht qualifizierte Förderung: json { "ai_qualified": false, "ai_qualification_reasoning": "Die Förderung richtet sich ausschließlich an Unternehmen und passt nicht zu den Kriterien für gemeinnützige Organisationen." }

Beispiel ohne Qualifizierung: json { "ai_qualified": null, "ai_qualification_reasoning": null }

Eigene Kategorien

Wenn für deinen API-Partner eigene Kategorien konfiguriert sind, werden alle Förderungen in deinem Scope automatisch durch KI in eine oder mehrere dieser partnerspezifischen Kategorien einsortiert. Das Ergebnis wird im Feld custom_categories zurückgegeben:

Feld Typ Beschreibung
custom_categories Array Liste der zugewiesenen Kategorien. Leer, wenn keine Kategorien konfiguriert sind oder die Förderung noch nicht kategorisiert wurde.
custom_categories[].id UUID Eindeutige Kategorie-ID
custom_categories[].name String Kategoriename auf Deutsch (kanonisch)
custom_categories[].name_en String Kategoriename auf Englisch

Eigene Kategorien werden pro API-Partner im Admin-Bereich verwaltet und sind völlig unabhängig von den globalen grant_areas. Sie sind für partnerspezifische Klassifizierungsschemata gedacht (z.B. kulturelle Sparten, thematische Tags).

Beispiel mit zugewiesenen Kategorien: json { "custom_categories": [ { "id": "a1b2c3d4-...", "name": "Bildende Kunst", "name_en": "Visual Arts" }, { "id": "e5f6a7b8-...", "name": "Kulturvermittlung", "name_en": "Cultural Education" } ] }

Beispiel ohne Kategorisierung (keine Kategorien konfiguriert oder noch nicht kategorisiert): json { "custom_categories": [] }

Fehler

Status Code Beschreibung
401 unauthorized Authentifizierung fehlgeschlagen
403 insufficient_scope Token hat nicht grants:read Scope
404 not_found Grant nicht gefunden oder außerhalb des Scopes

War diese Seite hilfreich?