Unabhängiger Anbieter. Daten aus gesetzlichen Quellen: Bekanntmachungsservice des Bundes, OffeneRegister und GLEIF.

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/{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

ParameterWoPflichtBedeutungBeispiel
sidPfadjaKennung 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

ParameterWoPflichtBedeutungBeispiel
sidPfadjaKennung der Firma.r2101-hrb12345
limitAbfrageneinZeilen je Seite, 1 bis 100 (Vorgabe 50). Free bekommt immer die letzten 5.50
cursorAbfrageneinNä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

ParameterWoPflichtBedeutungBeispiel
sidPfadjaKennung 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/{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

ParameterWoPflichtBedeutungBeispiel
idPfadjaKennung des Auftragnehmers (zehn Zeichen, Ende der Adresse seiner Seite).0a1b2c3d4e
limitAbfrageneinZeilen 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

ParameterWoPflichtBedeutungBeispiel
idPfadjaKennung des Auftragnehmers.0a1b2c3d4e
limitAbfrageneinZeilen je Seite, 1 bis 100 (Vorgabe 50). Free bekommt immer die letzten 5.50
cursorAbfrageneinNä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

ParameterWoPflichtBedeutungBeispiel
cpvAbfrageneinCPV-Abteilung (zwei Ziffern, z. B. 45 Bauarbeiten) oder -Gruppe (drei Ziffern, z. B. 909 Reinigung).45
stateAbfrageneinBundesland als NUTS-1-Code (DE1 bis DEG) oder wie in unseren Adressen (bayern).DE2
limitAbfrageneinZeilen je Seite, 1 bis 100 (Vorgabe 50). Free bekommt immer die letzten 5.50
cursorAbfrageneinNä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

ParameterWoPflichtBedeutungBeispiel
idPfadjaKennung 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/{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

ParameterWoPflichtBedeutungBeispiel
idPfadjaKennung des Auftraggebers (zehn Zeichen).1b2c3d4e5f
limitAbfrageneinZeilen 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

ParameterWoPflichtBedeutungBeispiel
idPfadjaKennung des Auftraggebers.1b2c3d4e5f
limitAbfrageneinZeilen je Seite, 1 bis 100 (Vorgabe 50). Free bekommt immer die letzten 5.50
cursorAbfrageneinNä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

ParameterWoPflichtBedeutungBeispiel
stateAbfrageneinBundesland als NUTS-1-Code oder wie in unseren Adressen.DE2
buyerAbfrageneinKennung eines Auftraggebers.1b2c3d4e5f
limitAbfrageneinTreffer, 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.

StatusCodeBedeutung
400invalid_idDie Kennung hat nicht die richtige Form.
400query_too_shortSuchbegriff unter drei Zeichen oder kein Filter.
400unsupported_filterEin Parameter ist unbekannt; die Antwort nennt ihn und die erlaubten.
400court_requiredEine Registernummer braucht das Registergericht (court).
400invalid_cpvUnbekannte CPV-Abteilung oder -Gruppe.
400invalid_stateUnbekanntes Bundesland.
400cursor_too_deepZu tiefe Seite; bitte Filter enger fassen.
401missing_or_invalid_keyKein Schlüssel im Header Authorization oder falsches Format.
401invalid_keyUnbekannter oder gesperrter Schlüssel.
403plan_without_all_awardsFree sieht die letzten 5 Zuschläge; weitere Seiten mit Pro oder Business.
404not_foundGibt es nicht, oder der Eintrag ist auf Wunsch ausgeblendet.
405method_not_allowedDie API kennt nur GET; MCP nur POST.
429rate_per_minuteMehr als 60 Abrufe in einer Minute; Retry-After nennt die Sekunden.
429monthly_credits_usedDie 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.