Endpoint: Zuwendungsempfänger

Die Eligible Entities-Endpoints ermöglichen den Zugriff auf alle verfügbaren Rechtsformen bzw. Zuwendungsempfänger-Typen. Nutze die zurückgegebenen IDs für Filter in Matching-Anfragen.

GET /api/v1/eligible_entities

Listet alle zulässigen Rechtsformen/Zuwendungsempfänger.

Scope erforderlich: grants:read

Beispiel-Request

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

Beispiel-Response

{
  "eligible_entities": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440200",
      "name": "Eingetragener Verein",
      "name_de": "Eingetragener Verein",
      "name_en": "Registered Association",
      "description": "Gemeinnützige Vereine nach deutschem Recht",
      "description_de": "Gemeinnützige Vereine nach deutschem Recht",
      "description_en": "Non-profit associations under German law"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440201",
      "name": "Stiftung",
      "name_de": "Stiftung",
      "name_en": "Foundation",
      "description": "Gemeinnützige Stiftungen",
      "description_de": "Gemeinnützige Stiftungen",
      "description_en": "Non-profit foundations"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440202",
      "name": "Gemeinnützige GmbH",
      "name_de": "Gemeinnützige GmbH",
      "name_en": "Non-profit Ltd.",
      "description": "Gemeinnützige Gesellschaft mit beschränkter Haftung",
      "description_de": "Gemeinnützige Gesellschaft mit beschränkter Haftung",
      "description_en": "Non-profit limited liability company"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440203",
      "name": "Körperschaft des öffentlichen Rechts",
      "name_de": "Körperschaft des öffentlichen Rechts",
      "name_en": "Public Law Corporation",
      "description": "Öffentlich-rechtliche Körperschaften wie Kommunen",
      "description_de": "Öffentlich-rechtliche Körperschaften wie Kommunen",
      "description_en": "Public law corporations such as municipalities"
    }
  ],
  "meta": {
    "total_count": 15
  }
}

GET /api/v1/eligible_entities/:id

Ruft Details eines einzelnen Zuwendungsempfänger-Typs ab.

Scope erforderlich: grants:read

Path-Parameter

Beispiel-Request

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

Beispiel-Response

{
  "eligible_entity": {
    "id": "550e8400-e29b-41d4-a716-446655440200",
    "name": "Eingetragener Verein",
    "name_de": "Eingetragener Verein",
    "name_en": "Registered Association",
    "name_plural": "Eingetragene Vereine",
    "name_plural_de": "Eingetragene Vereine",
    "name_plural_en": "Registered Associations",
    "description": "Gemeinnützige Vereine nach deutschem Recht",
    "description_de": "Gemeinnützige Vereine nach deutschem Recht",
    "description_en": "Non-profit associations under German law",
    "grants_count": 1245
  }
}

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": "Umwelt gGmbH",
    "description": "Gemeinnützige GmbH für Umweltprojekte",
    "eligible_entities": ["Gemeinnützige Organisation"]
  }
}

Hinweis: Du kannst Namen, Slugs oder UUIDs verwenden.

Typische Zuwendungsempfänger