• 06.10.2026 (Dienstag) - Stage-Umgebung (stage.pvog.fitko.net)
• 13.10.2026 (Dienstag) - Prod-Umgebung (pvog.fitko.net)

Im Regelfall sollte dies nicht zu Beeinträchtigungen führen.

Falls es in diesem Zeitraum zu kurzfristigen Beeinträchtigungen kommt, bitten wir dies zu entschuldigen. Sollten Sie Fragen haben, wenden Sie sich gern an den PVOG Support unter dataportpvogsupport@dataport.de.

Parallel zu den Blogbeiträgen werden die Wartungsarbeiten per Mail an den Verteiler der Anbindungsteilnehmer versandt. Wenn Sie keine E-Mail erhalten, aber Informationen zur Verfügbarkeit des PVOG benötigen, nehmen wir Sie gern in den Verteiler auf.

Die Release Note zum Release 9.24 wird nach dem Stage Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Ab diesem Zeitpunkt muss beim Abruf des Bereitstelldienstes der Nachfolger v3/verwaltungsobjekte/xzufi-2-3-1 verwendet werden.

Was ändert sich:

• Es ist beim Abruf keine Angabe der XZuFi Version im header mehr erforderlich.

• Der Endpunkt überträgt Leistungen, Leistungsspezialisierungen, Organisationseinheiten, Onlinedienste, Formulare und Zuständigkeiten als XZuFi Transfernachrichten. Mehrere Anfragen unter Verwendung des Update-Index können nötig sein, um alle Daten abzurufen. Der Umfang der abzufragenden Leistungsdaten kann durch Angabe von Amtlichen Regionalschlüsseln auf bestimmte Regionen eingeschränkt werden. Wenn die Daten nicht in der XZuFi-Version 2.3.1 an das PVOG geliefert wurden, werden die ausgelieferten Daten zuvor konvertiert.

Die aktuelle Anbindungsanleitung inkl. der Beschreibung der Schnittstelle liegt neu unter docs.fitko.de.

Für die geplante Nutzung des PVOG Bereitstelldienstes steht der Endpunkt v3/verwaltungsobjekte/xzufi-2-3-1 bereit.

Erzeugen Sie bereits Abfragen an den Bereitstelldienst, prüfen Sie bitte, ob v2/verwaltungsobjekte bei ihren Abfragen noch im Einsatz ist. Bei Fragen kontaktieren Sie uns gern!

Was ändert sich:

Der neue Endpunkt gibt das ursprüngliche XZuFi als JSON (JZuFi) der Zuständigkeits-Objekte in der XZuFi-Version 2.3.1 zurück. Ein Zuständigkeits-Objekt verknüpft Leistungen, Organisationseinheiten und Onlinedienste. Wenn die Auslieferungsversion der Daten von der Version abweicht, in der die Daten an das PVOG geliefert wurden, werden die ausgelieferten Daten entsprechend konvertiert.

Bitte prüfen Sie, ob v3/relations/{ars}/jzufi bei ihren Abfragen noch im Einsatz ist (wir haben aktuell ca. 60.000 Zugriffe in 7 Tagen) und planen ggf. die Umstellung auf v1/relations/jzufi-2-3 zeitnah ein.

Suchdienst Nutzer, die bereits eine ClientID (https://pvog.fitko.de/docs/ressourcen/client-id/) nutzen, werden von uns direkt kontaktiert.

Details finden Sie in der OpenAPI-Dokumentation (https://pvog.fitko.de/docs/umgebungen/umgebungen-ueberblick/).

Dieser Endpunkt löst perspektivisch den Endpunkt /v7/servicedescriptions/{ars} ab.

Ähnlich wie /v7/servicedescriptions/{ars} sucht /v8beta1/servicedescription in einem ARS-Bereich nach Leistungen, in denen der Suchbegriff enthalten ist. Das Ergebnis ist eine Liste von Leistungen.

Im Vergleich der beiden Endpunkte wurde sowohl das Input Modell, als auch das Output Modell reduziert und die Paginierung neu aufbereitet.

In der Abfrage (Input) sind Default Werte für page und size gesetzt. Das Gültigkeitsdatum ist jetzt immer der Zeitpunkt der Abfrage; für die Ausgabe muss die Leistung gültig sein. Dynamische Parameter werden standardmäßig ausgegeben.

Im Ergebnis (Output) wurden Details zur Leistung entfernt und Zugangskanäle (XZuFi Schema 2.3.1) hinzugefügt.

Aktuell ist der Endpunkt bereits am SuchClient (servicesuche.bund.de) implementiert.

Hinweis: Diese API-Änderungen sind noch im Beta-Stadium, also noch nicht produktiv. Wir wollen frühzeitig über diese Änderungen informieren. Nutzen Sie gern die OpenAPI Dokumentation zum Testen ihrer UseCases.

Bitte geben Sie, als Konsumenten gern Feedback zur Weiterentwicklung!

Suchdienst Nutzer, die bereits eine Client ID nutzen, werden von uns mit der Bitte um Feedback direkt kontaktiert.

Bei beiden Endpunkten sind ARS (Gebietsschlüssel) und Leistungsid (z.B. L100012.LB.9413106) die notwendigen Abfrageparameter. Als Ergebnis einer Abfrage werden alle Informationen und alle zuständigen Organisationseinheiten in einem bestimmten Gebiet (ARS) ausgegeben. Die Onlinedienst-Links in der Antwortmenge enthalten dynamische Parameter. Der Endpunkt liefert zum Zeitpunkt der Anfrage die aktuellsten Daten nach Gültigkeitszeitraum zurück.

Was ändert sich in v6/servicedescriptions/{lbid}/detail:

• Die Antwort wurde deutlich verschlankt und um Zugangskanäle erweitert.
• Der Such-Parameter validDate entfällt, es wird automatisch mit dem aktuellen Zeitstempel gesucht.
• Der Such-Parameter applyDynamicParams entfällt, es werden automatisch die dynamischen Parameter angewandt.

Bitte prüfen Sie, ob v5/servicedescriptions/{ars}/detail bei ihren Abfragen noch im Einsatz ist (wir haben aktuell ca. 400.000 Zugriffe in 7 Tagen) und planen ggf. die Umstellung auf v6/servicedescriptions/{lbid}/detail zeitnah ein.

Suchdienst Nutzer, die bereits ein ClientID nutzen, werden von uns direkt kontaktiert.

Details finden Sie in der OpenAPI-Dokumentation.

• 15.09.2026 (Dienstag) - Stage-Umgebung (stage.pvog.fikto.net)
• 22.09.2026 (Dienstag) - Prod-Umgebung (pvog.fitko.net)

Im Regelfall sollte dies nicht zu Beeinträchtigungen führen.

Falls es in diesem Zeitraum zu kurzfristigen Beeinträchtigungen kommt, bitten wir dies zu entschuldigen. Sollten Sie Fragen haben, wenden Sie sich gern an den PVOG Support unter dataportpvogsupport@dataport.de.

Parallel zu den Blogbeiträgen werden die Wartungsarbeiten per Mail an den Verteiler der Anbindungsteilnehmer versandt. Wenn Sie keine E-Mail erhalten, aber Informationen zur Verfügbarkeit des PVOG benötigen, nehmen wir Sie gern in den Verteiler auf.

Die ReleaseNote zum Release 9.23 wird nach dem Stage Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

• 22.08.2026 (Dienstag) - Stage-Umgebung (stage.pvog.fikto.net)
• 01.09.2026 (Dienstag) - Prod-Umgebung (pvog.fitko.net)

Im Regelfall sollte dies nicht zu Beeinträchtigungen führen.

Falls es in diesem Zeitraum zu kurzfristigen Beeinträchtigungen kommt, bitten wir dies zu entschuldigen. Sollten Sie Fragen haben, wenden Sie sich gern an den PVOG Support unter dataportpvogsupport@dataport.de.

Parallel zu den Blogbeiträgen werden die Wartungsarbeiten per Mail an den Verteiler der Anbindungsteilnehmer versandt. Wenn Sie keine E-Mail erhalten, aber Informationen zur Verfügbarkeit des PVOG benötigen, nehmen wir Sie gern in den Verteiler auf.

Die ReleaseNote zum Release 9.22 wird nach dem Stage Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

und

Um die Anforderungen schemakonform abzubilden, wurde im PVOGRelease 9.20 der Validator VAL0011 angepasst. Die Parameter OnlinedienstParameterIndividuellund OnlinedienstParameterEfA werden jetzt aus der Prüfung der maskiertenHTML-Tags ausgeschlossen.

Ergänzungen an Validator VAL 0053 waren nicht notwendig, danur Elemente geprüft werden, in den HTML-Tags nicht erlaubt sind.

Die Beschreibung der Validatoren kann unter https://docs.fitko.de/pvog/docs/validator/validierungsumfangXZuFi/validierungsregeln/uebersicht_validierungsregelnnachgelesen werden.

Bitte ändern Sie eventuelle Lesezeichen oder Favoriten in Ihrem Browser direkt. Die Weiterleitung der bisherigen Domain produktportal.pvog.fitko.de ist nur übergangsweise aktiv.

Mit der Umstellung endet die parallele Bereitstellung der Suchdienst APIs über die Domains pvog.fitko.de.

Die Endpunkte sind weiterhin unverändert über die Domains stage.pvog.fitko.net bzw. pvog.fitko.net erreichbar.

• 04.08.2026 (Dienstag) - Stage-Umgebung (stage.pvog.fikto.net)
• 11.08.2026 (Dienstag) - Prod-Umgebung (pvog.fitko.net)

Im Regelfall sollte dies nicht zu Beeinträchtigungen führen.

Falls es in diesem Zeitraum zu kurzfristigen Beeinträchtigungen kommt, bitten wir dies zu entschuldigen. Sollten Sie Fragen haben, wenden Sie sich gern an den PVOG Support unter dataportpvogsupport@dataport.de.

Parallel zu den Blogbeiträgen werden die Wartungsarbeiten per Mail an den Verteiler der Anbindungsteilnehmer versandt. Wenn Sie keine E-Mail erhalten, aber Informationen zur Verfügbarkeit des PVOG benötigen, nehmen wir Sie gern in den Verteiler auf.

Die ReleaseNote zum Release 9.21 wird nach dem Stage Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

• 15.07.2026 (Mittwoch) - Stage-Umgebung (stage.pvog.fikto.net)
• 21.07.2026 (Dienstag) - Prod-Umgebung (pvog.fitko.net)

Im Regelfall sollte dies nicht zu Beeinträchtigungen führen.

Falls es in diesem Zeitraum zu kurzfristigen Beeinträchtigungen kommt, bitten wir dies zu entschuldigen. Sollten Sie Fragen haben, wenden Sie sich gern an den PVOG Support unter dataportpvogsupport@dataport.de.

Parallel zu den Blogbeiträgen werden die Wartungsarbeiten per Mail an den Verteiler der Anbindungsteilnehmer versandt. Wenn Sie keine E-Mail erhalten, aber Informationen zur Verfügbarkeit des PVOG benötigen, nehmen wir Sie gern in den Verteiler auf.

Die ReleaseNote zum Release 9.20 wird nach dem Stage Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Inzwischen scheint die Störung behoben zu sein und die Schnittstellen funktionieren wieder wie gewohnt. Eine offizielle Meldung zur Entstörung liegt uns nun vor, deshalb können wir jetzt auch offiziell Entwarnung geben.

Vielen Dank für Ihr Verständnis!

Sämtliche Abschaltungen folgen einem festen vierteljährlichen Release-Rhythmus. Die reguläre Entfernung von Endpunkten erfolgt ausschließlich in den Monaten Februar, Mai, August oder November.

Regelmäßige Informationen zur Abschaltung von Endpunkten finden Sie unter Deprecations | PVOG Produktportal.

Der HTTP-Header X-PVOG-DEPRECATED​

Seit dem Release 8.1.1 signalisieren die Dienste den Status eines Endpunkts direkt in der Laufzeitumgebung. Jede Antwort eines als veraltet markierten Endpunkts enthält den folgenden HTTP-Header:

X-PVOG-DEPRECATED: true

Dieser Header dient als technischer Indikator in automatisierten Log-Analysen oder Monitoring-Systemen, um die Nutzung veralteter Schnittstellen im eigenen Code-Bestand zu identifizieren.

Betroffene Endpunkte (Stand: Mai 2026)​

Mit dem Release 9.17.4 (Mai 2026) wurden mehrere Endpunkte des Suchdienstes und des Bereitstelldienstes offiziell als deprecated markiert. Die Entfernung dieser Endpunkte aus der Produktionsumgebung ist für November 2026 terminiert.

1. Suchdienst​

Die folgenden Endpunkte werden im November 2026 abgeschaltet:

Veralteter Endpunkt                     Deprecation seit   Produktive Abschaltung  Aktueller Nachfolger / Migrationspfad
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
/v2/locations/suggestions               Mai 2026 (9.17.4)  November 2026           /v3/locations/suggestions
/v2/locations                           Mai 2026 (9.17.4)  November 2026           /v3/locations
/v2/organisationunits/jzufi             Mai 2026 (9.17.4)  November 2026           /v1/organisationunits/{id}/jzufi-2-3
/v3/relations/{ars}/jzufi               Mai 2026 (9.17.4)  November 2026           /v1/relations/jzufi-2-3
/v3/servicedescriptions/jzufi           Mai 2026 (9.17.4)  November 2026           /v1/servicedescriptions/{id}/jzufi-2-3
/v5/servicedescriptions/{ars}/detail    Mai 2026 (9.17.4)  November 2026           /v6/servicedescriptions/...

2. Bereitstelldienst​

Im Bereitstelldienst wurde mit dem Release 9.17.6 parallel ein neuer Endpunkt eingeführt, der den alten V2-Pfad ersetzt.

Bis zur endgültigen Abschaltung im November 2026 liefert der alte V2-Endpunkt ausschließlich Daten im Format XZuFi 2.3.1 aus und erfordert die explizite Übergabe der Version im Request-Header.

Veralteter Endpunkt       Deprecation seit   Produktive Abschaltung  Aktueller Nachfolger / Migrationspfad
──────────────────────────────────────────────────────────────────────────────────────────────────────────
/v2/verwaltungsobjekte    Mai 2026 (9.17.4)  November 2026           /v3/verwaltungsobjekte/xzufi-2-3-1

Neuer dedizierter Bereitstelldienst-Endpunkt für den Gesamtabruf im Format XZuFi 2.3.1 (siehe aktuelle OpenAPI-Spezifikation im Portal).

Weitere Dienste​

Für den Sammlerdienst und den Validator liegen mit dem aktuellen Release keine Deprecations vor. Die bestehenden Endpunkte dieser Dienste bleiben unverändert operativ.

Wenn Sie einen Zugriff auf den Bereitstelldienst anfragen wollen, können Sie dafür den neu geschaffenen Prozess im PVOG nutzen.

Wer bekommt Zugriff?​

Zugriff auf die API des Bereitstelldienstes haben

• Portale der öffentlichen Hand
• Dashboard Digitale Verwaltung
• Das Datenqualitätsprojekt der FITKO

Jeder Nutzer, bei dem kein berechtigtes Interesse an allen Daten des PVOG besteht, kann aktuell keinen Zugriff auf die API des Bereitstelldienstes erhalten.

Wie kann ich einen Zugang beantragen?​

Um einen Zugang zu beantragen, muss das auf dem Produktportal bereitgestellte Formular ausgefüllt und an den PVOG Support (dataportpvogsupport@dataport.de) gesendet werden. Der Prozess und das Formular sind hier zu finden:

Bereitstelldienst im Überblick | PVOG Produktportal

Was ist der Prozess bei einer Beantragung des Bereitstelldienst Zugangs?​

Nach der Übermittlung des Formulars wird dieses vom PVOG Support auf Vollständigkeit geprüft und anschließend an die FITKO weitergeleitet. Die FITKO prüft dann den Bedarf und übermittelt eine Entscheidung an den PVOG Support. Dieser meldet sich bei einer positiven Einschätzung bei den Anfragenden und richtet Zugänge für die Stage-Umgebung ein. Nach erfolgreichen Tests der Anfragenden auf der Stage-Umgebung, können im Anschluss Zugänge für die Prod-Umgebung eingerichtet werden.

Was beinhaltet das Formular zur Beantragung?​

Wichtig für die Beantragung des Zugangs ist ein nachgewiesenes, berechtigtes Interesse. Der Bund oder ein Bundesland müssen in diesem Fall die organisatorische Verantwortung für den sachgemäßen Umgang mit den Daten übernehmen.

Daneben sind die folgenden Inhalte Teil des Formulars:

1. Informationen zum Vorhabensprofil
2. Federführendes Land / Auftraggeber:in / Institution
3. Partnerorganisationen
4. Kontaktperson(en)
5. Vorhaben
6. Datennutzung
7. Absicherung der Datennutzung

Nach erfolgreicher Testphase und mit den Rückmeldungen zur v6beta3/servicedescription (vielen Dank dafür!) wurde der Endpunkt überarbeitet und mit dem PVOG Release 9.17. als v6/servicedescriptions/{lbid}/detail produktiv gesetzt.

Folgende Anpassungen wurden im Vergleich zu suchdienst/api/v5/servicedescriptions/:ars/detail vorgenommen:

• Die Antwort wurde deutlich verschlankt und um Zugangskanäle erweitert.
• Der Such-Parameter validDate entfällt, es wird automatisch mit dem aktuellen Zeitstempel gesucht.
• Der Such-Parameter applyDynamicParams entfällt, es werden automatisch die dynamischen Parameter angewandt.

Als Ergebnis einer Abfrage werden alle Informationen und alle zuständigen Organisationseinheiten in einem bestimmten Gebiet (ARS) ausgegeben. Die Onlinedienst-Links in der Antwortmenge enthalten dynamische Parameter. Der Endpunkt liefert zum Zeitpunkt der Anfrage die aktuellsten Daten nach Gültigkeitszeitraum zurück.

Um zu Änderungen an den öffentlichen Suchdienst Endpunkten informiert zu werden, nutzen Sie gern eine Client ID (vormals API Key).

• 23.06.2026 (Dienstag) - Stage-Umgebung (stage.pvog.fikto.net)
• 30.06.2026 (Dienstag) - Prod-Umgebung (pvog.fitko.net)

Im Regelfall sollte dies nicht zu Beeinträchtigungen führen.

Falls es in diesem Zeitraum zu kurzfristigen Beeinträchtigungen kommt, bitten wir dies zu entschuldigen. Sollten Sie Fragen haben, wenden Sie sich gern an den PVOG Support unter dataportpvogsupport@dataport.de.

Parallel zu den Blogbeiträgen werden die Wartungsarbeiten per Mail an den Verteiler der Anbindungsteilnehmer versandt. Wenn Sie keine E-Mail erhalten, aber Informationen zur Verfügbarkeit des PVOG benötigen, nehmen wir Sie gern in den Verteiler auf.

Die ReleaseNote zum Release 9.19 wird nach dem Stage Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Achtung!

Mit diesem Deployment wird die angekündigte Anpassung der PVOG Infrastruktur und die Anpassung an das FITKO Domain Konzept umgesetzt.

• Der Name der PreProd-Umgebung ändert sich auf "Stage-Umgebung".

• Die Demo-Umgebung und die Domain pvog-preprod.fitko.de werden abgeschaltet. Alle registierten Nutzer von Sammlerdienst, Bereitstelldienst, Validator, Konverter und Dienstleister der Redaktionssysteme wurden informiert.

• Die Suchdienst Endpunkte der Stage-Umgebung sind über stage.pvog.fitko.net erreichbar (nicht mehr pvog-preprod.fitko.de/).

• Das PVOG hat zukünftig nur noch zwei Umgebungen:

  • Stage-Umgebung - stage.pvog.fitko.net (für Testdaten) - zeigt bis zum 9.6. auf die Demo-Umgebung
  • Prod-Umgebung - pvog.fitko.net (Produktivsystem)

Durch das Umleiten der Domain kann es zu kurzfristigen Beeinträchtigungen kommen.

Sollten Sie im Umstellungsprozess Einschränkungen bemerken oder Fragen haben, wenden Sie sich bitte an unser Funktionspostfach dataportpvogsupport@dataport.de

Die ReleaseNote für Release 9.18.1 (und vorherige) finden Sie auch auf dem Produktportal.

• 03.06.2026 (Mittwoch) - Demo-Umgebung (stage.pvog.fikto.net)
• 09.06.2026 (Dienstag) - PreProd/Stage-Umgebung (pvog-preprod.fitko.de)
• 16.06.2026 (Dienstag) - Prod-Umgebung (pvog.fitko.net)

Im Regelfall sollte dies nicht zu Beeinträchtigungen führen.

Falls es in diesem Zeitraum zu kurzfristigen Beeinträchtigungen kommt, bitten wir dies zu entschuldigen. Sollten Sie Fragen haben, wenden Sie sich gern an den PVOG Support unter dataportpvogsupport@dataport.de.

Parallel zu den Blogbeiträgen werden die Wartungsarbeiten per Mail an den Verteiler der Anbindungsteilnehmer versandt. Wenn Sie keine E-Mail erhalten, aber Informationen zur Verfügbarkeit des PVOG benötigen, nehmen wir Sie gern in den Verteiler auf.

Die ReleaseNote zum Release 9.18 wird nach dem Demo Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Parallel dazu wurde mit demselben Release ein neuer Bereitstelldienst-Endpunkt eingeführt, der den Abruf des vollständigen Datenbestandes an Verwaltungsobjekten im Format XZuFi2.3.1 ermöglicht Produktportal. Dieser Endpunkt zeichnet sich dadurch aus, dass bei seiner Nutzung dieAngabe der XZuFi-Version im Header nicht mehr erforderlich ist, was die Handhabung vereinfacht.

Darüber hinaus wurde die Anbindungsanleitung des Bereitstelldienstes aktualisiert und steht ebenfalls auf dem Produktportal bereit, um eine reibungslose Integration und Nutzung der neuen API-Funktionalitäten zu gewährleisten (Link zur Anbindungsanleitung).

zum 9.6.2026 (mit dem PreProd-Deployment des PVOG Releases 9.18.) wird die lange angekündigte Optimierung der PVOG Infrastruktur erfolgen.

Mit der Abschaltung der Demo-Umgebung übernimmt die PreProd-Umgebung die Funktionen und die bestehende URL https://stage.pvog.fitko.net. Durch den Wegfall der Demo Umgebung können kürzere Releasezeiten bis zum Ausrollen von PVOG Releases bis zur PVOG Produktivumgebung realisiert werden. Die PreProd Umgebung wird als produktionsnahe Testumgebung mit Daten aus allen Redaktionssystemen aufgewertet. Außerdem können wir das FITKO-Domainkonzept abschließend umsetzen.

Was müssen Sie als, Bereitstelldienst-, Validator Service/API oder Konverter Service/API- Nutzende beachten?

• Der Link zum PVOG Dienst unter stage.pvog.fitko.net bleibt erhalten.
• Sollten Sie Zugangsdaten (Passwort oder Token) nur für die Demo Umgebung haben, bekommen Sie bis 26.5. neue Zugangsdaten.
• Sollten Sie Zugangsdaten (Passwort oder Token) für die PreProd Umgebung haben, blieben diese erhalten.
• Die PVOG Dienste der PreProd Umgebung sind ab 9.6.2026 nicht mehr über pvog-preprod.fitko.de erreichbar. Bitte nutzen Sie ab dem 9.6. den Zugriff über stage.pvog.fitko.net.

Was ist zu tun?

• Prüfen Sie bitte rechtzeitig, ob Ihnen die notwendigen Zugangsdaten für die PreProd Umgebung (bisher pvog-preprod.fitko.de) vorliegen und melden Sie sich, wenn bis zum 26.5.2026 keine ergänzenden Zugangsdaten bei Ihnen eingetroffen sind.
• Passen Sie Ihre Systeme ggf. an die neue Domain an.

Für Fragen zu Importen werden wir zeitnah direkt auf die jeweiligen Redaktionssysteme oder Dienstleister zugehen.

Sollten Sie Fragen haben, zögern Sie bitte nicht, uns anzusprechen!