Dokumentation der Firmendaten-API
Basisadresse https://firmenregisterdaten.de/api/v1. Jeder Aufruf braucht den Header Authorization: Bearer frd_… mit dem Schlüssel aus API und MCP im Konto. Antworten sind JSON in UTF-8, Beträge in Cent, Tage als JJJJ-MM-TT.
Die Beschreibung als OpenAPI 3.1: /api/v1/openapi.json (ohne Schlüssel abrufbar).
Abrufe und Grenzen
Jeder Aufruf kostet einen Abruf, außer /v1/sources. Jedes Konto hat 50 Abrufe je UTC-Monat, Pro ebenso, Business 1.000; dazu höchstens 60 Abrufe je Minute. Jede Antwort trägt X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset (Unix-Sekunden). Antworten werden nicht zwischengespeichert (Cache-Control: no-store). Die API sendet keine CORS-Freigabe: Der Schlüssel gehört auf Ihren Server, nicht in den Browser.
Listen mit cursor: Die Antwort nennt in nextCursor die nächste Seite, null heißt Ende. Free bekommt je Liste die letzten 5 Zuschläge mit dem Feld more für den Rest; Werte stehen dann nur als valueBand, valueCents, lowestCents und highestCents sind null.
Firmen aus dem Register
Findet eine Firma über Namen oder Registernummer und liefert Rechtsform, Register, Sitz, Status mit Stand, LEI, Insolvenzbekanntmachungen und die öffentlichen Aufträge, wo sie welche gewonnen hat. Ohne Namen von Geschäftsführung oder Vorstand.
GET /api/v1/companies
Firmen suchen. Sucht Firmen mit Registereintrag nach dem Anfang des Namens (mindestens drei Zeichen) oder genau nach Registernummer und Registergericht. Nur Firmen mit Rechtsform; keine Einzelkaufleute, keine Personengesellschaften mit Personennamen.
Tarif: Alle Tarife gleich. MCP: search_companies
| Parameter | Wo | Pflicht | Bedeutung | Beispiel |
|---|---|---|---|---|
q | Abfrage | nein | Anfang des Firmennamens, mindestens drei Zeichen. | Beispiel Bau |
register | Abfrage | nein | Registernummer mit Art, zusammen mit court. | HRB 12345 |
court | Abfrage | nein | Registergericht, mit oder ohne „Amtsgericht“. | München |
limit | Abfrage | nein | Treffer je Seite, 1 bis 50 (Vorgabe 25). | 25 |
cursor | Abfrage | nein | Nächste Seite, höchstens 20 Seiten. | 1 |
{
"results": [
{
"sid": "r2101-hrb12345",
"name": "Beispiel Bau GmbH",
"legalForm": "GmbH",
"register": "HRB 12345, Amtsgericht München",
"seat": "München",
"status": "active",
"page": "https://firmenregisterdaten.de/firma/beispiel-bau-gmbh--r2101-hrb12345"
}
],
"nextCursor": null
}
GET /api/v1/companies/{sid}
Firma aus dem Register. Registerangaben mit Stand (OffeneRegister 2017 bis 2019, aktualisiert über GLEIF, wo eine LEI bekannt ist), Abgleich mit dem Registerportal, LEI-Daten, Insolvenzbekanntmachungen der letzten sechs Monate und die Summe der öffentlichen Aufträge. Von Geschäftsführung und Vorstand nur die Zahl der Einträge, keine Namen.
Tarif: Alle Tarife gleich; die Summe der Aufträge genau in Cent nur mit Pro, Business, der Gratis-Firma oder einem Einzelabruf. MCP: get_company
| Parameter | Wo | Pflicht | Bedeutung | Beispiel |
|---|---|---|---|---|
sid | Pfad | ja | Kennung der Firma, der Teil nach „--“ in der Adresse ihrer Seite. | r2101-hrb12345 |
{
"sid": "r2101-hrb12345",
"name": "Beispiel Bau GmbH",
"legalForm": "GmbH",
"register": "HRB 12345, Amtsgericht München",
"seat": "München",
"status": "active",
"page": "https://firmenregisterdaten.de/firma/beispiel-bau-gmbh--r2101-hrb12345",
"registerArt": "HRB",
"registerNumber": "12345",
"court": "München",
"state": "DE2",
"stateName": "Bayern",
"address": "Beispielstraße 1, 80331 München",
"formerNames": [],
"asOf": "2018-05-02",
"gleifDay": "2026-11-10",
"lei": "5299000000000000EX01",
"registerPortalCheck": {
"day": "2026-11-14",
"status": "found"
},
"officers": {
"count": 2,
"asOf": "2018-05-02",
"names": "nicht über die API"
},
"publicAwards": {
"supplierId": "0a1b2c3d4e",
"awards": 37,
"buyers": 12,
"withValue": 30,
"valueBand": "5 bis 25 Mio. €",
"valueCents": 912345600,
"first": "2025-01-14",
"last": "2026-11-12",
"awardsUrl": "https://firmenregisterdaten.de/api/v1/companies/r2101-hrb12345/awards"
},
"insolvencyNotices": [],
"leiRecord": {
"lei": "5299000000000000EX01",
"legalName": "Beispiel Bau GmbH",
"entityStatus": "ACTIVE",
"leiStatus": "ISSUED",
"nextRenewal": "2027-03-01",
"registerNumber": "HRB 12345",
"court": "Amtsgericht München",
"fetchedAt": "2026-11-10"
},
"sources": [
"Registerangaben: OffeneRegister.de, from OpenCorporates (CC BY 4.0), erhoben 2017 bis 2019 aus den Registerbekanntmachungen und dem Registerportal der Länder."
]
}
GET /api/v1/companies/{sid}/awards
Zuschläge einer Firma. Die öffentlichen Aufträge, die die Firma laut Bekanntmachungsservice gewonnen hat, der neueste zuerst. Leer, wenn wir der Firma keinen Zuschlag sicher zuordnen.
Tarif: Free: die letzten 5 Zuschläge, Werte als Band. Pro und Business: alle Zuschläge seitenweise mit genauen Werten in Cent und der Angebotsspanne. Für die Gratis-Firma und einzeln gekaufte Firmen bekommt Free die vollen Angaben dieser Firma. MCP: get_company_awards
| Parameter | Wo | Pflicht | Bedeutung | Beispiel |
|---|---|---|---|---|
sid | Pfad | ja | Kennung der Firma. | r2101-hrb12345 |
limit | Abfrage | nein | Zeilen je Seite, 1 bis 100 (Vorgabe 50). Free bekommt immer die letzten 5. | 50 |
cursor | Abfrage | nein | Nächste Seite, wie sie die Antwort in nextCursor nennt; höchstens 50 Seiten. Nur Pro und Business. | 1 |
{
"exactValues": true,
"allAwards": true,
"total": 37,
"results": [
{
"noticeId": "00000000-0000-4000-8000-000000000001",
"lotId": "LOT-0001",
"published": "2026-11-12",
"title": "Sanierung Grundschule",
"lotTitle": "Dacharbeiten",
"cpv": "45261000",
"cpvLabel": "Dachdeckerarbeiten",
"state": "DE2",
"stateName": "Bayern",
"nuts": "DE212",
"supplier": {
"id": "0a1b2c3d4e",
"name": "Beispiel Bau GmbH",
"city": "München",
"page": "https://firmenregisterdaten.de/firma/beispiel-bau-gmbh-0a1b2c3d4e"
},
"consortium": false,
"buyer": {
"id": "1b2c3d4e5f",
"name": "Stadt Beispielstadt",
"page": "https://firmenregisterdaten.de/auftraggeber/stadt-beispielstadt-1b2c3d4e5f"
},
"submissions": 4,
"valueBand": "100.000 bis 500.000 €",
"valueCents": 21450000,
"lowestCents": 21450000,
"highestCents": 26800000,
"page": "https://firmenregisterdaten.de/zuschlag/00000000-0000-4000-8000-000000000001",
"officialUrl": "https://oeffentlichevergabe.de/ui/de/search/details?noticeId=00000000-0000-4000-8000-000000000001"
}
],
"nextCursor": "1",
"source": "Bekanntmachungsservice des Bundes (oeffentlichevergabe.de), offene Daten unter CC0. Kein Angebot des Bundes."
}
GET /api/v1/companies/{sid}/insolvenzen
Insolvenzbekanntmachungen einer Firma. Bekanntmachungen der Insolvenzgerichte zu dieser Firma aus den letzten sechs Monaten: Tag, Gegenstand, Insolvenzgericht und Aktenzeichen. Kein Wortlaut, keine Verwalter, keine Personen.
Tarif: Alle Tarife gleich. MCP: get_insolvency_notices
| Parameter | Wo | Pflicht | Bedeutung | Beispiel |
|---|---|---|---|---|
sid | Pfad | ja | Kennung der Firma. | r2101-hrb12345 |
{
"sid": "r2101-hrb12345",
"results": [
{
"published": "2026-11-03",
"subject": "EROEFF",
"subjectLabel": "Eröffnung",
"court": "München",
"fileNo": "1500 IN 1234/26"
}
],
"source": "Insolvenzbekanntmachungen der Insolvenzgerichte (Justizportal des Bundes und der Länder)"
}
Zuschläge und Auftragnehmer
Wer welche öffentlichen Aufträge gewonnen hat: je Auftragnehmer, je Branche (CPV) und Bundesland, je Bekanntmachung. Einzelunternehmen und Personen ohne Namen.
GET /api/v1/suppliers
Auftragnehmer suchen. Sucht Firmen, die öffentliche Aufträge gewonnen haben, nach Wörtern im Namen (jedes Wort als Anfang). Einzelunternehmen und Personen sind nicht suchbar.
Tarif: Alle Tarife gleich. MCP: search_suppliers
| Parameter | Wo | Pflicht | Bedeutung | Beispiel |
|---|---|---|---|---|
q | Abfrage | ja | Name oder Teile davon, mindestens drei Zeichen. | Beispiel Bau |
limit | Abfrage | nein | Treffer, 1 bis 50 (Vorgabe 20). | 20 |
{
"results": [
{
"id": "0a1b2c3d4e",
"name": "Beispiel Bau GmbH",
"city": "München",
"awards": 37,
"page": "https://firmenregisterdaten.de/firma/beispiel-bau-gmbh-0a1b2c3d4e"
}
]
}
GET /api/v1/suppliers/{id}
Auftragnehmer. Angaben aus den Bekanntmachungen (Sitz, USt-IdNr., Größe), Summen, die häufigsten Auftraggeber, Branchen und Jahre, der Registereintrag, wo wir ihn sicher zuordnen, und die neuesten Zuschläge.
Tarif: Free: die letzten 5 Zuschläge, Werte als Band. Pro und Business: alle Zuschläge seitenweise mit genauen Werten in Cent und der Angebotsspanne. Für die Gratis-Firma und einzeln gekaufte Firmen bekommt Free die vollen Angaben dieser Firma. MCP: get_supplier
| Parameter | Wo | Pflicht | Bedeutung | Beispiel |
|---|---|---|---|---|
id | Pfad | ja | Kennung des Auftragnehmers (zehn Zeichen, Ende der Adresse seiner Seite). | 0a1b2c3d4e |
limit | Abfrage | nein | Zeilen je Seite, 1 bis 100 (Vorgabe 50). Free bekommt immer die letzten 5. | 50 |
{
"id": "0a1b2c3d4e",
"name": "Beispiel Bau GmbH",
"city": "München",
"postCode": "80331",
"state": "DE2",
"vatId": "DE000000000",
"size": "small",
"lei": null,
"company": {
"sid": "r2101-hrb12345",
"page": "https://firmenregisterdaten.de/firma/beispiel-bau-gmbh--r2101-hrb12345"
},
"totals": {
"awards": 37,
"buyers": 12,
"withValue": 30,
"valueBand": "5 bis 25 Mio. €",
"valueCents": 912345600,
"first": "2025-01-14",
"last": "2026-11-12"
},
"topBuyers": [
{
"id": "1b2c3d4e5f",
"name": "Stadt Beispielstadt",
"awards": 9
}
],
"markets": [
{
"cpv": "45",
"label": "Bauarbeiten",
"awards": 31
}
],
"years": [
{
"year": 2026,
"awards": 20
}
],
"awards": {
"exactValues": true,
"allAwards": true,
"total": 37,
"results": [
{
"noticeId": "00000000-0000-4000-8000-000000000001",
"lotId": "LOT-0001",
"published": "2026-11-12",
"title": "Sanierung Grundschule",
"lotTitle": "Dacharbeiten",
"cpv": "45261000",
"cpvLabel": "Dachdeckerarbeiten",
"state": "DE2",
"stateName": "Bayern",
"nuts": "DE212",
"supplier": {
"id": "0a1b2c3d4e",
"name": "Beispiel Bau GmbH",
"city": "München",
"page": "https://firmenregisterdaten.de/firma/beispiel-bau-gmbh-0a1b2c3d4e"
},
"consortium": false,
"buyer": {
"id": "1b2c3d4e5f",
"name": "Stadt Beispielstadt",
"page": "https://firmenregisterdaten.de/auftraggeber/stadt-beispielstadt-1b2c3d4e5f"
},
"submissions": 4,
"valueBand": "100.000 bis 500.000 €",
"valueCents": 21450000,
"lowestCents": 21450000,
"highestCents": 26800000,
"page": "https://firmenregisterdaten.de/zuschlag/00000000-0000-4000-8000-000000000001",
"officialUrl": "https://oeffentlichevergabe.de/ui/de/search/details?noticeId=00000000-0000-4000-8000-000000000001"
}
],
"nextCursor": "1",
"source": "Bekanntmachungsservice des Bundes (oeffentlichevergabe.de), offene Daten unter CC0. Kein Angebot des Bundes."
}
}
GET /api/v1/suppliers/{id}/awards
Zuschläge eines Auftragnehmers. Alle Zuschläge eines Auftragnehmers, der neueste zuerst.
Tarif: Free: die letzten 5 Zuschläge, Werte als Band. Pro und Business: alle Zuschläge seitenweise mit genauen Werten in Cent und der Angebotsspanne. Für die Gratis-Firma und einzeln gekaufte Firmen bekommt Free die vollen Angaben dieser Firma. MCP: get_supplier_awards
| Parameter | Wo | Pflicht | Bedeutung | Beispiel |
|---|---|---|---|---|
id | Pfad | ja | Kennung des Auftragnehmers. | 0a1b2c3d4e |
limit | Abfrage | nein | Zeilen je Seite, 1 bis 100 (Vorgabe 50). Free bekommt immer die letzten 5. | 50 |
cursor | Abfrage | nein | Nächste Seite, wie sie die Antwort in nextCursor nennt; höchstens 50 Seiten. Nur Pro und Business. | 1 |
{
"exactValues": true,
"allAwards": true,
"total": 37,
"results": [
{
"noticeId": "00000000-0000-4000-8000-000000000001",
"lotId": "LOT-0001",
"published": "2026-11-12",
"title": "Sanierung Grundschule",
"lotTitle": "Dacharbeiten",
"cpv": "45261000",
"cpvLabel": "Dachdeckerarbeiten",
"state": "DE2",
"stateName": "Bayern",
"nuts": "DE212",
"supplier": {
"id": "0a1b2c3d4e",
"name": "Beispiel Bau GmbH",
"city": "München",
"page": "https://firmenregisterdaten.de/firma/beispiel-bau-gmbh-0a1b2c3d4e"
},
"consortium": false,
"buyer": {
"id": "1b2c3d4e5f",
"name": "Stadt Beispielstadt",
"page": "https://firmenregisterdaten.de/auftraggeber/stadt-beispielstadt-1b2c3d4e5f"
},
"submissions": 4,
"valueBand": "100.000 bis 500.000 €",
"valueCents": 21450000,
"lowestCents": 21450000,
"highestCents": 26800000,
"page": "https://firmenregisterdaten.de/zuschlag/00000000-0000-4000-8000-000000000001",
"officialUrl": "https://oeffentlichevergabe.de/ui/de/search/details?noticeId=00000000-0000-4000-8000-000000000001"
}
],
"nextCursor": "1",
"source": "Bekanntmachungsservice des Bundes (oeffentlichevergabe.de), offene Daten unter CC0. Kein Angebot des Bundes."
}
GET /api/v1/awards
Zuschläge nach Branche und Bundesland. Zuschläge einer Branche (CPV, zwei oder drei Ziffern), eines Bundeslands (Ort der Leistung) oder beider, der neueste zuerst. Mindestens einer der beiden Filter.
Tarif: Free: die letzten 5 Zuschläge, Werte als Band. Pro und Business: alle seitenweise mit genauen Werten. MCP: get_awards
| Parameter | Wo | Pflicht | Bedeutung | Beispiel |
|---|---|---|---|---|
cpv | Abfrage | nein | CPV-Abteilung (zwei Ziffern, z. B. 45 Bauarbeiten) oder -Gruppe (drei Ziffern, z. B. 909 Reinigung). | 45 |
state | Abfrage | nein | Bundesland als NUTS-1-Code (DE1 bis DEG) oder wie in unseren Adressen (bayern). | DE2 |
limit | Abfrage | nein | Zeilen je Seite, 1 bis 100 (Vorgabe 50). Free bekommt immer die letzten 5. | 50 |
cursor | Abfrage | nein | Nächste Seite, wie sie die Antwort in nextCursor nennt; höchstens 50 Seiten. Nur Pro und Business. | 1 |
{
"exactValues": true,
"allAwards": true,
"total": 37,
"results": [
{
"noticeId": "00000000-0000-4000-8000-000000000001",
"lotId": "LOT-0001",
"published": "2026-11-12",
"title": "Sanierung Grundschule",
"lotTitle": "Dacharbeiten",
"cpv": "45261000",
"cpvLabel": "Dachdeckerarbeiten",
"state": "DE2",
"stateName": "Bayern",
"nuts": "DE212",
"supplier": {
"id": "0a1b2c3d4e",
"name": "Beispiel Bau GmbH",
"city": "München",
"page": "https://firmenregisterdaten.de/firma/beispiel-bau-gmbh-0a1b2c3d4e"
},
"consortium": false,
"buyer": {
"id": "1b2c3d4e5f",
"name": "Stadt Beispielstadt",
"page": "https://firmenregisterdaten.de/auftraggeber/stadt-beispielstadt-1b2c3d4e5f"
},
"submissions": 4,
"valueBand": "100.000 bis 500.000 €",
"valueCents": 21450000,
"lowestCents": 21450000,
"highestCents": 26800000,
"page": "https://firmenregisterdaten.de/zuschlag/00000000-0000-4000-8000-000000000001",
"officialUrl": "https://oeffentlichevergabe.de/ui/de/search/details?noticeId=00000000-0000-4000-8000-000000000001"
}
],
"nextCursor": "1",
"source": "Bekanntmachungsservice des Bundes (oeffentlichevergabe.de), offene Daten unter CC0. Kein Angebot des Bundes."
}
GET /api/v1/notices/{id}
Bekanntmachung mit Losen und Zuschlägen. Eine Bekanntmachung: Auftraggeber, Art, Verfahren, Ort, Frist und je Los der Auftragnehmer mit Wert und Zahl der Angebote.
Tarif: Free: Werte als Band. Pro und Business: genaue Werte und Angebotsspanne. MCP: get_notice
| Parameter | Wo | Pflicht | Bedeutung | Beispiel |
|---|---|---|---|---|
id | Pfad | ja | Kennung der Bekanntmachung (UUID aus dem Bekanntmachungsservice). | 00000000-0000-4000-8000-000000000001 |
{
"noticeId": "00000000-0000-4000-8000-000000000001",
"noticeType": "can-standard",
"published": "2026-11-12",
"title": "Sanierung Grundschule",
"procedureType": "open",
"cpv": "45000000",
"state": "DE2",
"buyer": {
"id": "1b2c3d4e5f",
"name": "Stadt Beispielstadt",
"page": "https://firmenregisterdaten.de/auftraggeber/stadt-beispielstadt-1b2c3d4e5f"
},
"awards": [
{
"noticeId": "00000000-0000-4000-8000-000000000001",
"lotId": "LOT-0001",
"published": "2026-11-12",
"title": "Sanierung Grundschule",
"lotTitle": "Dacharbeiten",
"cpv": "45261000",
"cpvLabel": "Dachdeckerarbeiten",
"state": "DE2",
"stateName": "Bayern",
"nuts": "DE212",
"supplier": {
"id": "0a1b2c3d4e",
"name": "Beispiel Bau GmbH",
"city": "München",
"page": "https://firmenregisterdaten.de/firma/beispiel-bau-gmbh-0a1b2c3d4e"
},
"consortium": false,
"buyer": {
"id": "1b2c3d4e5f",
"name": "Stadt Beispielstadt",
"page": "https://firmenregisterdaten.de/auftraggeber/stadt-beispielstadt-1b2c3d4e5f"
},
"submissions": 4,
"valueBand": "100.000 bis 500.000 €",
"valueCents": 21450000,
"lowestCents": 21450000,
"highestCents": 26800000,
"page": "https://firmenregisterdaten.de/zuschlag/00000000-0000-4000-8000-000000000001",
"officialUrl": "https://oeffentlichevergabe.de/ui/de/search/details?noticeId=00000000-0000-4000-8000-000000000001"
}
],
"officialUrl": "https://oeffentlichevergabe.de/ui/de/search/details?noticeId=00000000-0000-4000-8000-000000000001"
}
Auftraggeber
Öffentliche Auftraggeber mit ihren vergebenen Aufträgen und den Firmen, die sie am häufigsten beauftragen.
GET /api/v1/buyers
Auftraggeber suchen. Sucht öffentliche Auftraggeber nach Wörtern im Namen.
Tarif: Alle Tarife gleich. MCP: search_buyers
| Parameter | Wo | Pflicht | Bedeutung | Beispiel |
|---|---|---|---|---|
q | Abfrage | ja | Name oder Teile davon, mindestens drei Zeichen. | Stadt Beispielstadt |
limit | Abfrage | nein | Treffer, 1 bis 50 (Vorgabe 20). | 20 |
{
"results": [
{
"id": "1b2c3d4e5f",
"name": "Stadt Beispielstadt",
"city": "Beispielstadt",
"awards": 140,
"page": "https://firmenregisterdaten.de/auftraggeber/stadt-beispielstadt-1b2c3d4e5f"
}
]
}
GET /api/v1/buyers/{id}
Auftraggeber. Angaben aus den Bekanntmachungen (Ort, Art, Leitweg-ID), Summen, die häufigsten Auftragnehmer und Branchen, offene Ausschreibungen und die neuesten Zuschläge.
Tarif: Free: die letzten 5 Zuschläge, Summen gerundet. Pro und Business: genaue Werte. MCP: get_buyer
| Parameter | Wo | Pflicht | Bedeutung | Beispiel |
|---|---|---|---|---|
id | Pfad | ja | Kennung des Auftraggebers (zehn Zeichen). | 1b2c3d4e5f |
limit | Abfrage | nein | Zeilen je Seite, 1 bis 100 (Vorgabe 50). Free bekommt immer die letzten 5. | 50 |
{
"id": "1b2c3d4e5f",
"name": "Stadt Beispielstadt",
"city": "Beispielstadt",
"state": "DE2",
"legalType": "ra-aut",
"leitwegId": null,
"notices": 210,
"totals": {
"awards": 140,
"suppliers": 88,
"withValue": 120,
"valueAbout": "rund 48 Mio. €",
"valueCents": 4812345600,
"first": "2025-01-03",
"last": "2026-11-12"
},
"topSuppliers": [
{
"id": "0a1b2c3d4e",
"name": "Beispiel Bau GmbH",
"awards": 9
}
],
"markets": [
{
"cpv": "45",
"label": "Bauarbeiten",
"awards": 60
}
],
"openTenders": 3,
"awards": {
"exactValues": true,
"allAwards": true,
"total": 37,
"results": [
{
"noticeId": "00000000-0000-4000-8000-000000000001",
"lotId": "LOT-0001",
"published": "2026-11-12",
"title": "Sanierung Grundschule",
"lotTitle": "Dacharbeiten",
"cpv": "45261000",
"cpvLabel": "Dachdeckerarbeiten",
"state": "DE2",
"stateName": "Bayern",
"nuts": "DE212",
"supplier": {
"id": "0a1b2c3d4e",
"name": "Beispiel Bau GmbH",
"city": "München",
"page": "https://firmenregisterdaten.de/firma/beispiel-bau-gmbh-0a1b2c3d4e"
},
"consortium": false,
"buyer": {
"id": "1b2c3d4e5f",
"name": "Stadt Beispielstadt",
"page": "https://firmenregisterdaten.de/auftraggeber/stadt-beispielstadt-1b2c3d4e5f"
},
"submissions": 4,
"valueBand": "100.000 bis 500.000 €",
"valueCents": 21450000,
"lowestCents": 21450000,
"highestCents": 26800000,
"page": "https://firmenregisterdaten.de/zuschlag/00000000-0000-4000-8000-000000000001",
"officialUrl": "https://oeffentlichevergabe.de/ui/de/search/details?noticeId=00000000-0000-4000-8000-000000000001"
}
],
"nextCursor": "1",
"source": "Bekanntmachungsservice des Bundes (oeffentlichevergabe.de), offene Daten unter CC0. Kein Angebot des Bundes."
}
}
GET /api/v1/buyers/{id}/awards
Zuschläge eines Auftraggebers. Alle Zuschläge eines Auftraggebers, der neueste zuerst; bei Bietergemeinschaften eine Zeile je Los.
Tarif: Free: die letzten 5 Zuschläge, Werte als Band. Pro und Business: alle seitenweise mit genauen Werten. MCP: get_buyer_awards
| Parameter | Wo | Pflicht | Bedeutung | Beispiel |
|---|---|---|---|---|
id | Pfad | ja | Kennung des Auftraggebers. | 1b2c3d4e5f |
limit | Abfrage | nein | Zeilen je Seite, 1 bis 100 (Vorgabe 50). Free bekommt immer die letzten 5. | 50 |
cursor | Abfrage | nein | Nächste Seite, wie sie die Antwort in nextCursor nennt; höchstens 50 Seiten. Nur Pro und Business. | 1 |
{
"exactValues": true,
"allAwards": true,
"total": 37,
"results": [
{
"noticeId": "00000000-0000-4000-8000-000000000001",
"lotId": "LOT-0001",
"published": "2026-11-12",
"title": "Sanierung Grundschule",
"lotTitle": "Dacharbeiten",
"cpv": "45261000",
"cpvLabel": "Dachdeckerarbeiten",
"state": "DE2",
"stateName": "Bayern",
"nuts": "DE212",
"supplier": {
"id": "0a1b2c3d4e",
"name": "Beispiel Bau GmbH",
"city": "München",
"page": "https://firmenregisterdaten.de/firma/beispiel-bau-gmbh-0a1b2c3d4e"
},
"consortium": false,
"buyer": {
"id": "1b2c3d4e5f",
"name": "Stadt Beispielstadt",
"page": "https://firmenregisterdaten.de/auftraggeber/stadt-beispielstadt-1b2c3d4e5f"
},
"submissions": 4,
"valueBand": "100.000 bis 500.000 €",
"valueCents": 21450000,
"lowestCents": 21450000,
"highestCents": 26800000,
"page": "https://firmenregisterdaten.de/zuschlag/00000000-0000-4000-8000-000000000001",
"officialUrl": "https://oeffentlichevergabe.de/ui/de/search/details?noticeId=00000000-0000-4000-8000-000000000001"
}
],
"nextCursor": "1",
"source": "Bekanntmachungsservice des Bundes (oeffentlichevergabe.de), offene Daten unter CC0. Kein Angebot des Bundes."
}
Offene Ausschreibungen
Ausschreibungen mit Frist ab heute, nach Bundesland oder Auftraggeber, die nächste Frist zuerst.
GET /api/v1/tenders
Offene Ausschreibungen. Ausschreibungen mit Frist ab heute, die nächste Frist zuerst. Teilnahme und Unterlagen nur über die amtliche Bekanntmachung.
Tarif: Alle Tarife gleich; der geschätzte Auftragswert nur mit Pro und Business. MCP: get_open_tenders
| Parameter | Wo | Pflicht | Bedeutung | Beispiel |
|---|---|---|---|---|
state | Abfrage | nein | Bundesland als NUTS-1-Code oder wie in unseren Adressen. | DE2 |
buyer | Abfrage | nein | Kennung eines Auftraggebers. | 1b2c3d4e5f |
limit | Abfrage | nein | Treffer, 1 bis 100 (Vorgabe 50). | 50 |
{
"results": [
{
"noticeId": "00000000-0000-4000-8000-000000000001",
"published": "2026-11-10",
"deadline": "2026-12-08",
"title": "Reinigung Verwaltungsgebäude",
"cpv": "90910000",
"cpvLabel": "Reinigungsarbeiten",
"state": "DE2",
"buyer": {
"id": "1b2c3d4e5f",
"name": "Stadt Beispielstadt",
"page": "https://firmenregisterdaten.de/auftraggeber/stadt-beispielstadt-1b2c3d4e5f"
},
"estimatedValueCents": null,
"officialUrl": "https://oeffentlichevergabe.de/ui/de/search/details?noticeId=00000000-0000-4000-8000-000000000001"
}
],
"source": "Bekanntmachungsservice des Bundes (oeffentlichevergabe.de), offene Daten unter CC0. Kein Angebot des Bundes."
}
Quellen und Stand
Jede Quelle mit Herausgeber, Art und Lizenz, dazu der zuletzt geladene Tag der Bekanntmachungen. Kostet keinen Abruf.
GET /api/v1/sources
Quellen und Stand. Jede Quelle mit Herausgeber, Art, Lizenz und wofür wir sie nutzen, dazu der zuletzt geladene Tag der Bekanntmachungen.
Tarif: Alle Tarife gleich; kostet keinen Abruf. Kostet keinen Abruf.
{
"lastImportDay": "2026-11-15",
"sources": [
{
"key": "vergabe",
"publisher": "Bekanntmachungsservice des Bundes (Datenservice Öffentlicher Einkauf, Beschaffungsamt des BMI)",
"kind": "amtliche Quelle",
"licence": "offene Daten unter CC0",
"url": "https://oeffentlichevergabe.de"
}
]
}
Fehler
Fehler kommen als JSON mit dem Feld error, bei 429 zusätzlich limit und resetAt.
| Status | Code | Bedeutung |
|---|---|---|
| 400 | invalid_id | Die Kennung hat nicht die richtige Form. |
| 400 | query_too_short | Suchbegriff unter drei Zeichen oder kein Filter. |
| 400 | unsupported_filter | Ein Parameter ist unbekannt; die Antwort nennt ihn und die erlaubten. |
| 400 | court_required | Eine Registernummer braucht das Registergericht (court). |
| 400 | invalid_cpv | Unbekannte CPV-Abteilung oder -Gruppe. |
| 400 | invalid_state | Unbekanntes Bundesland. |
| 400 | cursor_too_deep | Zu tiefe Seite; bitte Filter enger fassen. |
| 401 | missing_or_invalid_key | Kein Schlüssel im Header Authorization oder falsches Format. |
| 401 | invalid_key | Unbekannter oder gesperrter Schlüssel. |
| 403 | plan_without_all_awards | Free sieht die letzten 5 Zuschläge; weitere Seiten mit Pro oder Business. |
| 404 | not_found | Gibt es nicht, oder der Eintrag ist auf Wunsch ausgeblendet. |
| 405 | method_not_allowed | Die API kennt nur GET; MCP nur POST. |
| 429 | rate_per_minute | Mehr als 60 Abrufe in einer Minute; Retry-After nennt die Sekunden. |
| 429 | monthly_credits_used | Die Abrufe des Monats sind verbraucht; limit und resetAt (Beginn des nächsten UTC-Monats) stehen in der Antwort. |
MCP
JSON-RPC 2.0 über Streamable HTTP unter https://firmenregisterdaten.de/mcp (nur POST, Antworten als JSON, kein Stream). initialize, tools/list und ping brauchen keinen Schlüssel und kosten nichts; jeder tools/call braucht den Schlüssel und kostet einen Abruf. Die Werkzeuge nehmen dieselben Parameter wie die REST-Aufrufe und antworten mit demselben JSON als Text.
{
"mcpServers": {
"firmenregisterdaten": {
"type": "http",
"url": "https://firmenregisterdaten.de/mcp",
"headers": { "Authorization": "Bearer frd_…" }
}
}
}
Beispiele mit erfundener Firma. Die Inhalte sind keine Rechts- oder Vergabeberatung; maßgeblich sind die amtliche Bekanntmachung und das Register. Kein Angebot des Bundes.