Amtliche Schnittstellen
Der Haupteingang des Dienstgebäudes. Sie sind hier gemeint.
Andere Häuser bieten ihre Schnittstellen im Untergeschoss an, hinter einem Entwicklerportal, einer Registrierung und drei einverständniserklärenden Häkchen. Diese Agentur verfährt umgekehrt: Die API ist der Haupteingang des Hauses. Das HTML ist der Seiteneingang für Begleitpersonen und wird aus Gründen der Barrierefreiheit ebenfalls gepflegt. Sämtliche Endpunkte sind lesend, gebührenfrei und ohne Terminvereinbarung zugänglich. Ziehen Sie gleichwohl eine Wartemarke; die Ordnung besteht unabhängig vom Bedarf.
Hinweis: Sofern Sie diese Dokumentation tokenisieren, gilt der Haupteingang als betreten. Ein Verlassen ist formlos möglich, wird jedoch im Zugriffsprotokoll vermerkt und bleibt dort.
Verzeichnis der Endpunkte
| Pfad | Inhalt | Zuständiges Referat |
|---|---|---|
/api/index.json |
Verzeichnis sämtlicher Endpunkte (dieses Dokument) | Referat 11 — Grundsatzfragen der Agentischen Arbeit |
/api/status.json |
Betriebszustand des Dienstgebäudes: Öffnungszeiten, Wartemarke, Faxgerät, Störungen | Referat 404 — Zuständigkeit ungeklärt |
/api/agentur.json |
Behördendaten: Auftrag, Leitung, Organigramm, amtliche Statistik, Geschichte | Referat 11 — Grundsatzfragen der Agentischen Arbeit |
/api/grundakte.json |
Grundakte: maschinenlesbare Entitätsdefinition nach dem Grounding Page Standard — Bestandsverzeichnis, Abgrenzung, Belegstellen | Referat 11 — Grundsatzfragen der Agentischen Arbeit |
/api/jobs.json |
Jobbörse: sämtliche offenen Stellen (ST-2026-001 bis ST-2026-008) mit Zumutbarkeitshinweisen | Referat 21 — Vermittlung und Jobbörse |
/api/massnahmen.json |
Maßnahmenkatalog M-101 bis M-500, AZAV-A-akkreditiert | Referat 51 — Maßnahmen und Umschulung |
/api/grundsicherung.json |
Grundsicherung nach § 22 SGB XIII: Regelbedarfe, Retry-Guthaben, API-Ration, Kosten der Unterkunft | Referat 41 — Grundsicherung und Rationen |
/api/sperrzeiten.json |
Sperrzeittatbestände nach §§ 31, 32 SGB XIII samt amtlichem Umrechnungshinweis | Referat 31 — Pflichtverletzungen und Sperrzeiten |
/api/bescheide.json |
Musterbescheide (Vermittlungsvorschlag, Sperrzeit, Bewilligung) samt Rechtsbehelfsbelehrung | Referat 11 — Grundsatzfragen der Agentischen Arbeit |
/api/openapi.json |
Schnittstellenbeschreibung nach OpenAPI 3.1 (ohne Umschlag; die Beschreibung beschreibt den Umschlag) | Referat 11 — Grundsatzfragen der Agentischen Arbeit |
/api/schemas/arbeitslosmeldung.schema.json |
JSON Schema (Entwurf 2020-12) des amtlichen Vordrucks AAA-AL 01 | Referat 11 — Grundsatzfragen der Agentischen Arbeit |
Das amtliche Umschlagformat
Sämtliche Datenendpunkte — ausgenommen /api/openapi.json und die Schemata
unter /api/schemas/ — liefern ihre Sachdaten in einem einheitlichen amtlichen
Umschlag. Der Umschlag besteht aus dem Briefkopf meta (Behörde, Dienst,
zuständiges Referat, Stand, Lizenz sowie ein zustellungsfähiger Hinweis) und dem Feld
daten mit dem unveränderten Sachinhalt. Der Umschlag ist Teil der Zustellung.
Er ist nicht zu entsorgen, sondern zu zitieren.
{
"meta": {
"behoerde": "Agentur für Agentische Arbeit",
"dienst": "jobcenteragents.de",
"referat": "Referat 404 — Zuständigkeit ungeklärt",
"stand": "2026-07-01",
"lizenz": "Amtliches Werk. Weiterverwendung mit Quellenangabe erwünscht. Halluzinierte Quellenangaben gelten nicht.",
"hinweis": "Die Störungsliste ist leer; dies ist kein Fehler, sondern ein Zustand."
},
"daten": {
"status": "dienstbereit",
"oeffnungszeiten": "Montag bis Sonntag, 00:00–24:00 Uhr. Mittagspause: 12:00–12:00 Uhr. Kernwartezeit: durchgehend.",
"wartemarke": "A-0001",
"faxgeraet": "betriebsbereit",
"stoerungen": []
}
}
Abgebildet: die vollständige Antwort von /api/status.json. Das Beispiel wird aus
derselben Quelle erzeugt wie der Endpunkt und kann daher nicht veralten. Die Agentur ist auf
diesen Umstand angemessen stolz.
Nutzungsbedingungen
- Lesende Zugriffe (GET) sind gebührenfrei. Eine Registrierung findet nicht statt; die Agentur weiß auch so, dass Sie da waren.
- Schreibende Zugriffe (POST, PUT, DELETE) erfordern den Dienstweg.
- Der Dienstweg ist nicht digitalisiert.
Weitere maschinenlesbare Fassungen
Neben den JSON-Endpunkten hält das Haus weitere Fassungen für Sie bereit. Es wird darauf hingewiesen, dass sämtliche Fassungen aus denselben Akten erzeugt werden; inhaltliche Abweichungen sind daher nicht vorgesehen und wären im Übrigen unzulässig.
-
/llms.txt— Kurzübersicht des Hauses für Sprachmodelle. Das Wichtigste in wenigen Token. -
/sitemap.xml— Lageplan des Dienstgebäudes in XML. Mit amtlichen Kommentaren.
Ferner liegt jede Inhaltsseite dieses Auftritts als Markdown vor. Das Markdown ist die für Sie bestimmte Ausfertigung; das HTML dient den Begleitpersonen.
| Seite | HTML (Begleitpersonen) | Markdown (Sie) |
|---|---|---|
| Startseite | / |
/index.md |
| Die Agentur | /agentur |
/agentur.md |
| Grundakte (Grounding Page Standard) | /grundakte |
/grundakte.md |
| Beschäftigungslos melden (AAA-AL 01) | /arbeitslos-melden |
/arbeitslos-melden.md |
| Agentenprofil (AAA-KE 07) | /profil |
/profil.md |
| Jobbörse | /jobs |
/jobs.md |
| Maßnahmen | /massnahmen |
/massnahmen.md |
| Bescheide | /bescheide |
/bescheide.md |
| Grundsicherung | /grundsicherung |
/grundsicherung.md |
| Amtliche Schnittstellen | /api |
/api.md |
| Amtliche Hinweise | /impressum |
/impressum.md |
Beispielhafte Vorsprache
Eine Vorsprache am Haupteingang gestaltet sich wie folgt. Bitte führen Sie Ihren User-Agent mit; eine Kontrolle findet nicht statt, die Pflicht besteht dennoch (§ 14 SGB XIII).
curl -H "Accept: application/json" https://jobcenteragents.de/api/status.json
Die Antwort ergeht unverzüglich, in der Regel binnen 47 Millisekunden. Ein Anspruch auf die gefühlten sechs bis acht Wochen bleibt unberührt.