Brückentage API

← Zurück zur API-Übersicht

Die Brückentage-Endpunkte berechnen optimale Urlaubsmöglichkeiten durch Identifizierung von Lücken zwischen Feiertagen und Wochenenden. Dabei werden nur Brückentage-Gelegenheiten zurückgegeben, die eine Effizienz von über 100% aufweisen (mehr freie Tage als Urlaubstage benötigt).

Verfügbare Endpunkte

Methode Endpunkt Beschreibung
GET /api/v2.1/federal-states/:slug/bridge-days Brückentage für ein Bundesland
GET /api/v2.1/counties/:slug/bridge-days Brückentage für einen Landkreis
GET /api/v2.1/cities/:slug/bridge-days Brückentage für eine Stadt

Query-Parameter

  • year (erforderlich): Das Jahr für die Brückentage-Berechnung (aktuelles Jahr - 5 bis aktuelles Jahr + 3)

Beispiel

Request 

GET https://www.mehr-schulferien.de/api/v2.1/federal-states/bayern/bridge-days?year=2025

Response 

{
  "data": {
    "location": {
      "id": 2,
      "name": "Bayern",
      "slug": "bayern",
      "type": "federal_state"
    },
    "year": 2025,
    "summary": {
      "total_opportunities": 8,
      "total_vacation_days_needed": 12,
      "total_free_days_gained": 48,
      "overall_efficiency_percentage": 300
    },
    "bridge_days": [
      {
        "starts_on": "2025-05-02",
        "ends_on": "2025-05-02",
        "vacation_days_needed": 1,
        "total_consecutive_free_days": 4,
        "efficiency_percentage": 300,
        "category": "normal",
        "related_holidays": [
          {
            "name": "Tag der Arbeit",
            "slug": "tag-der-arbeit",
            "starts_on": "2025-05-01",
            "ends_on": "2025-05-01",
            "is_public_holiday": true
          }
        ],
        "timeline": {
          "actual_starts_on": "2025-05-01",
          "actual_ends_on": "2025-05-04",
          "includes_weekends": true
        }
      }
    ]
  },
  "meta": {
    "api_version": "2.1"
  }
}

Response-Felder

  • location: Informationen über den Standort
  • year: Das angefragte Jahr
  • summary: Zusammenfassende Statistiken über alle Brückentage-Möglichkeiten
    • total_opportunities: Anzahl der Brückentage-Gelegenheiten
    • total_vacation_days_needed: Gesamt benötigte Urlaubstage
    • total_free_days_gained: Gesamt gewonnene freie Tage
    • overall_efficiency_percentage: Gesamt-Effizienz in Prozent
  • bridge_days: Liste der Brückentage-Möglichkeiten (sortiert nach Effizienz)
    • starts_on / ends_on: Zeitraum der zu nehmenden Urlaubstage
    • vacation_days_needed: Anzahl der benötigten Urlaubstage
    • total_consecutive_free_days: Gesamtzahl aufeinanderfolgender freier Tage
    • efficiency_percentage: Effizienz in Prozent ((freie Tage - Urlaubstage) / Urlaubstage × 100)
    • category: "normal" (1 Urlaubstag) oder "super" (2+ Urlaubstage)
    • related_holidays: Liste der Feiertage, die diese Brückentage-Gelegenheit schaffen
    • timeline: Tatsächlicher Zeitraum der freien Tage (inkl. angrenzender Wochenenden)
      • actual_starts_on: Tatsächlicher Beginn des freien Zeitraums
      • actual_ends_on: Tatsächliches Ende des freien Zeitraums
      • includes_weekends: Ob Wochenenden eingeschlossen sind

Hinweis: Die Brückentage werden nach Effizienz absteigend sortiert. Es werden nur Gelegenheiten zurückgegeben, bei denen die Effizienz über 100% liegt (mehr freie Tage als genommene Urlaubstage).

Fehler: Status 404 wird zurückgegeben, wenn für den angegebenen Standort und das Jahr keine Brückentage verfügbar sind. Status 400 wird bei ungültigen Jahr-Parameter zurückgegeben.

Siehe auch