Endpoint: Zielgruppen

Die Target Groups-Endpoints ermöglichen den Zugriff auf alle verfügbaren Zielgruppen. Nutze die zurückgegebenen IDs für Filter in Matching-Anfragen und um die Zielgruppen-Zuordnungen von Förderprogrammen zu verstehen.

GET /api/v1/target_groups

Listet alle verfügbaren Zielgruppen.

Scope erforderlich: grants:read

Beispiel-Request

curl -X GET "https://foerdermittelkompass.reflecta.org/api/v1/target_groups" \
  -H "Authorization: Bearer rfk_dein_token" \
  -H "Content-Type: application/json"

Beispiel-Response

{
  "target_groups": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440300",
      "name": "Kinder & Jugendliche",
      "name_de": "Kinder & Jugendliche",
      "name_en": "Children & Youth"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440301",
      "name": "Familien & Eltern",
      "name_de": "Familien & Eltern",
      "name_en": "Families & Parents"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440302",
      "name": "Senioren",
      "name_de": "Senioren",
      "name_en": "Seniors"
    }
  ],
  "meta": {
    "total_count": 26
  }
}

GET /api/v1/target_groups/:id

Ruft Details einer einzelnen Zielgruppe ab, inkl. Anzahl der zugeordneten Förderprogramme.

Scope erforderlich: grants:read

Path-Parameter

Beispiel-Request

curl -X GET "https://foerdermittelkompass.reflecta.org/api/v1/target_groups/550e8400-e29b-41d4-a716-446655440300" \
  -H "Authorization: Bearer rfk_dein_token"

Beispiel-Response

{
  "target_group": {
    "id": "550e8400-e29b-41d4-a716-446655440300",
    "name": "Kinder & Jugendliche",
    "name_de": "Kinder & Jugendliche",
    "name_en": "Children & Youth",
    "grants_count": 842
  }
}

Zielgruppen in Förderprogrammen

Jedes Förderprogramm enthält in der API-Antwort ein target_groups-Array mit den zugeordneten Zielgruppen:

{
  "grant": {
    "title": "Jugendförderung Bayern",
    "target_groups": [
      { "id": "550e8400-...", "name": "Kinder & Jugendliche" },
      { "id": "550e8400-...", "name": "Familien & Eltern" }
    ],
    "target_group_description": "Fördert Projekte für Kinder und Jugendliche..."
  }
}

Hinweis: Zusätzlich zum strukturierten target_groups-Array gibt es das Freitextfeld target_group_description, das eine ausführliche Beschreibung der Zielgruppe enthält.

Verwendung für Matching

Die zurückgegebenen Zielgruppen-Namen können im organization_profile der Matching-Anfrage verwendet werden:

POST /api/v1/matching
{
  "organization_id": "partner-org-123",
  "organization_profile": {
    "name": "Jugendverein München e.V.",
    "description": "Gemeinnütziger Verein für Jugendarbeit",
    "target_groups": ["Kinder & Jugendliche", "Familien & Eltern"]
  }
}

Typische Zielgruppen