Beispiel-Requests

Hier findest du typische API-Anfragen und Antworten für die wichtigsten Anwendungsfälle.

Förderprogramme abrufen

Alle Förderprogramme auflisten

GET /api/v1/grants
Authorization: Bearer rfk_dein_token_hier

Antwort:

{
  "grants": [
    {
      "id": "abc-123",
      "slug": "kulturfoerderung-bayern",
      "title": "Kulturförderung Bayern",
      "short_description": "Förderung kultureller Projekte in Bayern",
      "grant_type": "subsidy",
      "deadline": "2026-06-30",
      "ongoing_grant": false,
      "max_funding_amount": 50000,
      "grant_provider": {
        "id": "provider-456",
        "name": "Bayerisches Staatsministerium",
        "slug": "bayerisches-staatsministerium"
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 42,
    "total_count": 1024
  }
}

Mit Filtern suchen

GET /api/v1/grants?q=umwelt&grant_type=subsidy&page=1&per_page=25
Authorization: Bearer rfk_dein_token_hier

Einzelnes Förderprogramm abrufen

GET /api/v1/grants/kulturfoerderung-bayern
Authorization: Bearer rfk_dein_token_hier

---

Fördergeber abrufen

Alle Fördergeber auflisten

GET /api/v1/grant_providers
Authorization: Bearer rfk_dein_token_hier

Antwort:

{
  "grant_providers": [
    {
      "id": "provider-456",
      "name": "Bayerisches Staatsministerium",
      "slug": "bayerisches-staatsministerium",
      "grant_provider_type": "state_ministry",
      "website": "https://www.stmwk.bayern.de",
      "city": "München",
      "grants_count": 15
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 8,
    "total_count": 187
  }
}

Einzelnen Fördergeber abrufen

GET /api/v1/grant_providers/bayerisches-staatsministerium
Authorization: Bearer rfk_dein_token_hier

---

KI-Matching

Matching starten

Das Matching läuft asynchron. Du startest es mit einem POST-Request und erhältst eine ID zum Abrufen der Ergebnisse.

POST /api/v1/matching
Authorization: Bearer rfk_dein_token_hier
Content-Type: application/json

{
  "organization_id": "meine-org-123",
  "organization_profile": {
    "name": "Kulturverein München e.V.",
    "description": "Gemeinnütziger Verein zur Förderung zeitgenössischer Kunst und Kultur in München.",
    "legal_form": "eingetragener_verein",
    "regions": ["bayern"],
    "grant_areas": ["kultur"]
  },
  "project": {
    "title": "Digitale Kunstwerkstatt",
    "description": "Einrichtung eines Kreativraums mit digitalen Tools für junge Künstler:innen."
  }
}

Antwort:

{
  "matching_request_id": "match-789",
  "status": "pending",
  "status_url": "/api/v1/matching/match-789",
  "results_url": "/api/v1/matching/match-789/results",
  "message": "Matching process started. Poll status_url for progress."
}

Matching-Ergebnisse abrufen

GET /api/v1/matching/match-789
Authorization: Bearer rfk_dein_token_hier

Antwort (wenn fertig):

{
  "matching_request_id": "match-789",
  "status": "completed",
  "results_count": 12,
  "results": [
    {
      "grant_id": "abc-123",
      "title": "Kulturförderung Bayern",
      "relevance_score": 0.92,
      "match_reasons": ["Passende Region", "Kulturbereich"]
    }
  ]
}

---

Kontingent prüfen

GET /api/v1/usage/quota
Authorization: Bearer rfk_dein_token_hier

Antwort:

{
  "quarter": "Q1 2026",
  "matching_requests": {
    "used": 450,
    "limit": 1000,
    "remaining": 550
  },
  "active_organizations": 23
}

---

Filterparameter

Für Förderprogramme (/api/v1/grants)

Parameter	Beschreibung	Beispiel
q	Volltextsuche	q=umwelt
grant_type	Förderart	grant_type=subsidy
region_ids[]	Region-IDs	region_ids[]=uuid
grant_area_ids[]	Förderbereich-IDs	grant_area_ids[]=uuid
page	Seitennummer	page=2
per_page	Ergebnisse pro Seite (max. 100)	per_page=50

Für Fördergeber (/api/v1/grant_providers)

Parameter	Beschreibung	Beispiel
q	Suche nach Name	q=ministerium
grant_provider_type	Typ des Fördergebers	grant_provider_type=state_ministry
page	Seitennummer	page=2
per_page	Ergebnisse pro Seite	per_page=50