API

Die API bringt Ausschreibungen aus procuris in Ihr eigenes System, ohne Abtippen. Eine API ist eine Schnittstelle, über die zwei Programme Daten austauschen. Sie liefert denselben Bestand, den procuris selbst nutzt: Bekanntmachungen aus TED (dem Amtsblatt der EU für Ausschreibungen), bund.de und mehr als 90 Vergabeportalen.

Eine Ausschreibung soll in Ihrem System ein Datensatz sein, nicht mehrere. Erscheint eine Bekanntmachung auf mehreren Portalen, führt procuris sie zu einem Datensatz zusammen. Erkennt procuris eine Dublette erst später, archiviert es den jüngeren Datensatz und verweist auf den bleibenden. Wie Ihr System damit umgeht, steht im Datenmodell.

Der Bestand bekommt höchstens einmal je Stunde einen neuen Stand. Ein Abruf liefert den letzten Stand von procuris, nicht den Stand, den die Vergabestelle in diesem Moment veröffentlicht.

Was Sie bekommen

Ein Datensatz beschreibt eine Ausschreibung mit den Angaben ihrer Bekanntmachung. Er enthält Titel, Beschreibung, Vergabenummer, Auftraggeber mit Kontakt, Angebots- und Teilnahmefrist, Auftragswert, CPV-Codes für die Branche, Region, Verfahrensart, Lose, Status und Originalquelle. Hat die Vergabestelle keinen Auftragswert veröffentlicht, liefert procuris eine Schätzung, soweit eine vorliegt, und markiert sie als Schätzung. Gibt es weder einen veröffentlichten noch einen geschätzten Wert, steht dort null, also kein Wert. Das Datenmodell listet die Felder mit Typ und Beispiel.

Vier Dinge aus procuris liefert die API nicht:

• die Passung, also wie gut eine Ausschreibung zu Ihrem Unternehmen passt, von 0 bis 100
• Ihre Suchaufträge, also gespeicherte Suchen, die jeden Morgen weiterlaufen und neue Ausschreibungen mailen
• deren Treffer, also die Ausschreibungen, die ein Suchauftrag gefunden hat
• die Vergabeunterlagen, also die Dokumente der Vergabestelle für Ihr Angebot

Treffer mit Passung bekommt Ihr System über Webhooks mit dem Ereignis search.hit. Die API kann sie nicht nachliefern, weil sie keine Passung und keine Suchaufträge kennt.

Wofür Firmen die API nutzen

• Vertrieb: Bauausschreibungen aus Ihrer Region landen als Verkaufschance im CRM (der Software für Kunden und Verkaufschancen). Sollen alle Ausschreibungen zu Ihren Filtern ins CRM, braucht es die API und Webhooks: die API für die Erstbefüllung (das einmalige Übertragen des Bestands) und den nächtlichen Abgleich, Webhooks für Änderungen dazwischen. Sollen nur die Treffer Ihrer Suchaufträge ins CRM, reichen Webhooks ohne API. Beide Varianten beschreibt CRM und ERP.
• Planung: Angebotsfristen und Auftragswerte stehen nach dem nächtlichen Abgleich im ERP (der Software für Aufträge und Planung) oder im BI-Werkzeug (der Software für Auswertungen), statt von Hand übertragen zu werden.
• Marktbeobachtung: Ausschreibungen einer Branche über mehrere Jahre vergleichen, weil das Archiv bis Januar 2022 zurückreicht.

Was Ihre IT bereitstellt

Ihre IT braucht drei Dinge, aber keinen Zugang von außen. Anders als bei Webhooks ruft Ihr System die Daten ab, statt sie zu empfangen. Ihr Netz muss darum keine Anfragen von außen annehmen.

• einen Dienst, der stündlich oder nächtlich läuft und HTTPS-Abrufe nach außen machen darf
• einen Secret-Speicher (geschützter Ablageort für Zugangsdaten) für das Token
• eine Liste, welches procuris-Feld in welches Feld Ihres Systems kommt. Ihr System legt Datensätze über die feste id einer Ausschreibung an und aktualisiert sie über dieselbe id.

Die meiste Arbeit macht die Feldliste, nicht der Abgleich. Ihre IT entscheidet je Feld, wohin es in Ihrem System gehört und wie es dort heißt. Der Abgleich selbst besteht aus sechs Schritten, beschrieben unter Filter und Takt.

Ihr erster Abruf

Ist der Zugang eingerichtet, genügen für den ersten Abruf vier Schritte.

GET /v1/tenders?cpv=45000000&nuts=DEG&updated_since=2026-09-24T00:00:00Z&limit=5 HTTP/1.1
Host: api.procuris.eu
Authorization: Bearer <Ihr Token>
Accept: application/json

Auf einen Blick