Förderthemen

Endpoint: Förderthemen

Die Grant Areas-Endpoints ermöglichen den Zugriff auf alle verfügbaren Förderthemen (Förderbereiche). Nutze die zurückgegebenen IDs für Filter in Matching-Anfragen und Förderprogramm-Suchen.

GET /api/v1/grant_areas

Listet alle Förderthemen. Standardmäßig in hierarchischer Struktur (Oberkategorien mit Unterkategorien).

Scope erforderlich: grants:read

Query-Parameter

Parameter	Typ	Beschreibung
`flat`	String	Wenn `"true"`, wird eine flache Liste zurückgegeben
`include_parent`	String	Wenn `"true"`, werden auch Oberkategorien in der flachen Liste inkludiert (Standard: nur Unterkategorien)

Beispiel-Request (hierarchisch)

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

Beispiel-Response (hierarchisch)

{
  "grant_areas": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Umwelt & Klima",
      "name_de": "Umwelt & Klima",
      "name_en": "Environment & Climate",
      "subareas": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440001",
          "name": "Klimaschutz",
          "name_de": "Klimaschutz",
          "name_en": "Climate Protection"
        },
        {
          "id": "550e8400-e29b-41d4-a716-446655440002",
          "name": "Naturschutz",
          "name_de": "Naturschutz",
          "name_en": "Nature Conservation"
        }
      ]
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440010",
      "name": "Soziales",
      "name_de": "Soziales",
      "name_en": "Social Affairs",
      "subareas": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440011",
          "name": "Jugendarbeit",
          "name_de": "Jugendarbeit",
          "name_en": "Youth Work"
        }
      ]
    }
  ],
  "meta": {
    "total_parent_areas": 12,
    "total_subareas": 45
  }
}

Beispiel-Request (flache Liste)

curl -X GET "https://foerdermittelkompass.reflecta.org/api/v1/grant_areas?flat=true" \
  -H "Authorization: Bearer rfk_dein_token"

Beispiel-Response (flache Liste)

{
  "grant_areas": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "name": "Klimaschutz",
      "name_de": "Klimaschutz",
      "name_en": "Climate Protection",
      "parent_id": "550e8400-e29b-41d4-a716-446655440000",
      "parent_name": "Umwelt & Klima",
      "is_parent": false
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "name": "Naturschutz",
      "name_de": "Naturschutz",
      "name_en": "Nature Conservation",
      "parent_id": "550e8400-e29b-41d4-a716-446655440000",
      "parent_name": "Umwelt & Klima",
      "is_parent": false
    }
  ],
  "meta": {
    "total_count": 45,
    "filterable_count": 45
  }
}

GET /api/v1/grant_areas/:id

Ruft Details eines einzelnen Förderthemas ab.

Scope erforderlich: grants:read

Path-Parameter

Parameter	Typ	Beschreibung
`id`	UUID	Förderthema-ID

Beispiel-Request

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

Beispiel-Response (Unterkategorie)

{
  "grant_area": {
    "id": "550e8400-e29b-41d4-a716-446655440001",
    "name": "Klimaschutz",
    "name_de": "Klimaschutz",
    "name_en": "Climate Protection",
    "is_parent": false,
    "parent": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Umwelt & Klima",
      "name_de": "Umwelt & Klima",
      "name_en": "Environment & Climate"
    }
  }
}

Beispiel-Response (Oberkategorie)

{
  "grant_area": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Umwelt & Klima",
    "name_de": "Umwelt & Klima",
    "name_en": "Environment & Climate",
    "is_parent": true,
    "subareas": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440001",
        "name": "Klimaschutz",
        "name_de": "Klimaschutz",
        "name_en": "Climate Protection",
        "parent_id": "550e8400-e29b-41d4-a716-446655440000",
        "parent_name": "Umwelt & Klima",
        "is_parent": false
      }
    ]
  }
}

Verwendung für Matching

Die zurückgegebenen IDs, Namen oder Slugs können im organization_profile der Matching-Anfrage verwendet werden:

POST /api/v1/matching
{
  "organization_id": "partner-org-123",
  "organization_profile": {
    "name": "Klimaschutz e.V.",
    "description": "...",
    "grant_areas": ["Energieeffizienz & Klimaschutz", "Forschung & Innovation"]
  }
}

Hinweis: Du kannst Namen, Slugs oder UUIDs verwenden. Sowohl Haupt- als auch Unterkategorien können als Filter verwendet werden.

Suche

Menu