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

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"
        }
      ],
      "updated_at": "2026-01-15T10:30:00Z"
    }
  ],
  "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

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": "foerderung@stmwk.bayern.de",
      "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" }
    ],
    "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"
  }
}

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.

Fehler