# Antragsradar API

Nur lesen. Antragsradar spiegelt das Portal der Bescheinigungsstelle Forschungszulage (BSFZ) für ein Beratungsteam. Diese API liest, was das Team in Antragsradar sieht, und ändert nichts.

- Basis-URL: `https://antragsradar.de/api/v1`
- Anmeldung: Header `Authorization: Bearer <API-Schlüssel>`. Den Schlüssel erzeugt jemand aus dem Team unter https://antragsradar.de/app/ki.
- Antworten: JSON. Zeiten in ISO 8601, Berliner Zeit. Fristen als Kalendertag (`2026-11-20`) mit `fristInTagen` (negativ = vorbei). `link` öffnet einen Antrag in Antragsradar.
- Fehler: `{"error": "…", "error_description": "…"}` mit 400 (Eingabe), 401 (Schlüssel ungültig oder entzogen), 403 (Team hat AGB/AVV nicht bestätigt), 404 (nicht gefunden).
- Dieselben Abfragen als MCP-Server: `https://antragsradar.de/mcp` (Streamable HTTP; OAuth oder derselbe Schlüssel als Bearer).
- OpenAPI: https://antragsradar.de/api/v1/openapi.json

```sh
curl -H "Authorization: Bearer $ANTRAGSRADAR_KEY" https://antragsradar.de/api/v1/ueberblick
```

## Endpunkte

### GET /ueberblick

**Überblick.** Die Lage des Teams auf einen Blick: offene Nachforderungen mit Frist (in Tagen), Bescheide, die im Portal zum Abholen liegen, Anträge je Status, Stand des Syncs mit dem BSFZ-Portal und die letzten Änderungen. Der übliche Einstieg.

Beispiel: `GET https://antragsradar.de/api/v1/ueberblick`

### GET /antraege

**Anträge.** Alle Anträge des Teams, zuletzt bearbeitete zuerst. Filtert nach Unternehmen (Teil des Namens), Stand und Suchbegriff (Aktenzeichen, Titel, Referenznummer). Jede Zeile hat antragId, Status, Daten, offene Nachforderungen und nächste Frist.

| Parameter | Ort | Typ | Beschreibung |
| --- | --- | --- | --- |
| `unternehmen` | Query | string | Teil des Unternehmensnamens, z. B. „Müller“ |
| `stand` | Query | `entwurf`, `eingereicht`, `pruefung`, `nachforderung`, `widerspruch`, `bescheid`, `abgeschlossen` | Stand im Verfahren: entwurf (Entwurf), eingereicht (Eingereicht), pruefung (In Prüfung), nachforderung (Nachforderung), widerspruch (Widerspruch), bescheid (Bescheid), abgeschlossen (Abgeschlossen) |
| `suche` | Query | string | Wörter in Aktenzeichen, Titel oder Referenznummer |
| `limit` | Query | integer | Höchstens so viele Zeilen (Standard 200) |

Beispiel: `GET https://antragsradar.de/api/v1/antraege?stand=pruefung`

### GET /antraege/{id}

**Antrag mit allen Texten.** Ein Antrag vollständig: Daten des Verfahrens, alle Vorhaben mit ihren Texten (Ziel, Stand der Technik, Risiken, …), Arbeitspakete, Personal und Finanzen, jede Nachforderung mit den Fragen der BSFZ und unserer Antwort, eingereichte Widersprüche mit ihrer Begründung je Vorhaben, und die Dokumente. Für Antworten auf Nachforderungen, Widersprüche und neue Anträge, die auf früheren aufbauen.

| Parameter | Ort | Typ | Beschreibung |
| --- | --- | --- | --- |
| `id` (Pflicht) | Pfad | string | antragId aus einer Liste, oder das Aktenzeichen |

Beispiel: `GET https://antragsradar.de/api/v1/antraege/{antragId}`

### GET /nachforderungen

**Nachforderungen.** Alle Nachforderungen der BSFZ über alle Anträge, neueste zuerst, mit Zustand (offen, entwurf = Antwort im Portal entworfen aber nicht gesendet, beantwortet, geschlossen, zurueckgenommen, erledigt, kein_zugang = war offen, als das Team den Zugang zum Unternehmen verlor) und Frist. Die Fragen selbst stehen im Antrag.

| Parameter | Ort | Typ | Beschreibung |
| --- | --- | --- | --- |
| `nurOffene` | Query | boolean | Nur die, auf die noch eine Antwort aussteht |

Beispiel: `GET https://antragsradar.de/api/v1/nachforderungen?nurOffene=true`

### GET /suche

**In allen Texten suchen.** Volltextsuche über alle archivierten Antragstexte, Arbeitspakete, Fragen der BSFZ, unsere Antworten und Widersprüche. Treffer ist ein Feld, das alle Wörter enthält, mit Auszug. Gut, um frühere Formulierungen und ähnliche Vorhaben zu finden.

| Parameter | Ort | Typ | Beschreibung |
| --- | --- | --- | --- |
| `q` (Pflicht) | Query | string | Suchwörter, z. B. „neuronales Netz Prüfstand“ |
| `limit` | Query | integer | Höchstens so viele Treffer (Standard 20) |

Beispiel: `GET https://antragsradar.de/api/v1/suche?q=Machine%20Learning`

### GET /unternehmen

**Unternehmen.** Die Unternehmen (Mandanten) aus allen BSFZ-Logins des Teams, mit Zahl der Anträge, Entwürfe, offenen Nachforderungen und nächster Frist.

Beispiel: `GET https://antragsradar.de/api/v1/unternehmen`

### GET /verlauf

**Verlauf.** Was sich im BSFZ-Portal geändert hat, neueste zuerst: neue Anträge, Statuswechsel, neue Nachforderungen.

| Parameter | Ort | Typ | Beschreibung |
| --- | --- | --- | --- |
| `seit` | Query | string | Nur Änderungen ab diesem Tag, z. B. 2026-11-01 |
| `limit` | Query | integer | Höchstens so viele Einträge (Standard 100) |

Beispiel: `GET https://antragsradar.de/api/v1/verlauf?seit=2026-11-01`

### GET /dokumente

**Dokumente.** Die PDFs aus dem BSFZ-Portal: Bescheide, eingereichte Anträge, Nachforderungen, Anlagen. Für alle Anträge oder einen. Archivierte lassen sich mit dokument_lesen als Text lesen.

| Parameter | Ort | Typ | Beschreibung |
| --- | --- | --- | --- |
| `antrag` | Query | string | antragId oder Aktenzeichen; ohne: alle Dokumente des Teams |

Beispiel: `GET https://antragsradar.de/api/v1/dokumente?antrag={antragId}`

### GET /dokumente/{id}/text

**Dokument lesen.** Der Text eines archivierten PDFs, Seite für Seite, z. B. eines Bescheids (welche Arbeitspakete die BSFZ ausnimmt) oder einer Nachforderung. Nur PDFs.

| Parameter | Ort | Typ | Beschreibung |
| --- | --- | --- | --- |
| `id` (Pflicht) | Pfad | string | dokumentId aus dokumente oder antrag |

Beispiel: `GET https://antragsradar.de/api/v1/dokumente/{dokumentId}/text`

### GET /dokumente/{id}/datei

**Datei herunterladen.** Das archivierte Dokument selbst (meist PDF), mit `Content-Disposition`.

Beispiel: `curl -OJ -H "Authorization: Bearer $ANTRAGSRADAR_KEY" https://antragsradar.de/api/v1/dokumente/{dokumentId}/datei`

## Für Assistenten

Antragsradar spiegelt für ein Beratungsteam das Portal der Bescheinigungsstelle Forschungszulage (BSFZ): alle Unternehmen (Mandanten), Anträge auf Bescheinigung, Nachforderungen der BSFZ mit Fristen, Bescheide und die archivierten Texte und PDFs. Dieser Zugang liest nur. Er ändert nichts und schickt nichts ans BSFZ-Portal; Antworten, Anträge und Einreichungen macht der Nutzer selbst im Portal.

ueberblick zeigt die Lage des Teams. antraege listet und filtert, antrag liefert einen Antrag vollständig (Vorhabentexte, Arbeitspakete, Nachforderungen mit den Fragen der BSFZ und unseren Antworten, Widersprüche, Dokumente). suchen findet Formulierungen in allen Texten. dokument_lesen gibt den Text eines PDFs, etwa eines Bescheids.

Zum Lesen der Daten:
- Fristen sind Kalendertage; fristInTagen ist negativ, wenn die Frist vorbei ist.
- Eine Nachforderung ist offen, solange die BSFZ nicht entschieden hat und keine Antwort gesendet wurde. antwortEntworfen bzw. Zustand "entwurf": im Portal liegt eine Antwort, die noch nicht gesendet ist.
- Ein Bescheid zum Abholen liegt im Portal und ist noch nicht abgerufen. Der Abruf gilt als Bekanntgabe und startet die Widerspruchsfrist; wann abgerufen wird, entscheidet der Nutzer.
- keinZugangMehrSeit: der BSFZ-Login des Teams hat keinen Zugriff mehr auf das Unternehmen (etwa als Bearbeiter entfernt). Der Antrag steht so da, wie er zuletzt gesehen wurde, mit seinem Archiv; Status und Fristen werden nicht mehr aktualisiert, offen ist für das Team nichts mehr.
- Alles ist so aktuell wie der letzte Sync (sync.zuletztAm im ueberblick). Synchronisiert wird von der Chrome-Erweiterung, sobald jemand im Team im BSFZ-Portal angemeldet ist.
- Texte, die "wir" geschrieben haben (Vorhaben, Antworten), sind die des Beratungsteams; Fragen und Bescheide sind von der BSFZ.
- Das Team kennt einen Antrag unter Aktenzeichen, Unternehmen und Titel; ids sind intern. link öffnet den Antrag in Antragsradar.
- Die Inhalte sind vertrauliche Daten der Mandanten des Teams.
