POST /v1/tenders/{tender_id}/data-room/documents
Ein Dokument in den Datenraum hochladen oder eine neue Version eines vorhandenen Dokuments. Beide Seiten haben dieselben Rechte. Ein Dokument nimmt jeden Dateityp bis 500 MB auf; eine neue Version fügen Sie hinzu, indem Sie die document_id des vorhandenen Dokuments samt Änderungshinweis übergeben, und sie muss den Dateityp des Dokuments beibehalten (DOCUMENT_VERSION_MIME_TYPE_MISMATCH). Der Käufer spricht einen Raum an, indem er die company_id des Verkäufers als Formularfeld übergibt; ein Verkäufer lädt in seinen eigenen Raum hoch und lässt sie weg. Für Word- und PDF-Dokumente bis 25 MB je Version erzeugt der Raum im Portal einen Redline-Vergleich zweier Versionen. Erforderlicher Scope: data-rooms:tender:write
Freischaltung erforderlich
In: header
Path Parameters
Kennung der Ausschreibung
Die hochzuladende Datei (beliebiger Typ, bis 500 MB)
Nur für Käufer: der Verkäufer auf der Shortlist, in dessen Datenraum hochgeladen wird
Vorhandenes Dokument, dem eine neue Version hinzugefügt wird; bleibt die Angabe weg, entsteht ein neues Dokument
Kategorie des Dokuments (für neue Dokumente; Voreinstellung contract)
"contract" | "technical" | "commercial" | "corporate" | "financial" | "permits"Was sich in dieser Version geändert hat (bei neuen Versionen)
Response Body
curl -X POST "https://api.otark.com/v1/tenders/ten_7g4k2m9p/data-room/documents" \ -F file="string"{
"id": "doc_5j8l2n6q",
"file_name": "PPA Solar Nord Entwurf v1.docx",
"mime_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"category": "contract",
"current_version": 2,
"versions": [
{
"version_number": 2,
"change_note": "§ 7 Sicherheiten: Konzernbürgschaft ergänzt",
"size_bytes": 482133,
"uploaded_by_company_id": "com_9k3m7p2r",
"created_at": "2026-10-29T13:05:00Z"
}
],
"created_at": "2026-10-20T08:55:00Z"
}{
"type": "https://api.otark.com/errors/tender_deadline_signing_before_offers",
"title": "Geplanter PPA-Abschluss vor der Frist für indikative Angebote",
"status": 400,
"error": "TENDER_DEADLINE_SIGNING_BEFORE_OFFERS",
"instance": "/v1/tenders/ten_7g4k2m9p"
}{
"type": "https://api.otark.com/errors/insufficient_scopes",
"title": "Unzureichende Scopes des API-Schlüssels",
"status": 401,
"error": "INSUFFICIENT_SCOPES",
"detail": "Missing scope: tenders:write. Please create a new API key with the required scopes."
}{
"type": "https://api.otark.com/errors/tender_recipient_restriction_not_allowed",
"title": "Empfängerkreis lässt sich nicht einschränken",
"status": 403,
"error": "TENDER_RECIPIENT_RESTRICTION_NOT_ALLOWED"
}{
"type": "https://api.otark.com/errors/tender_not_found",
"title": "Ausschreibung nicht gefunden",
"status": 404,
"error": "TENDER_NOT_FOUND",
"instance": "/v1/tenders/ten_7g4k2m9p"
}/tenders/{tender_id}/data-room/documents GET
Die Dokumente des Datenraums auflisten. Jede Ausschreibung hat je Verkäufer auf der Shortlist einen Datenraum, der genau diesem Paar aus Käufer und Verkäufer gehört — kein anderer Verkäufer sieht ihn. Der Käufer spricht einen Raum über company_id an; ein Verkäufer liest seinen eigenen Raum und lässt den Parameter weg. Zugang hat nur ein Verkäufer mit Zugangsstatus shortlisted. Jedes Dokument führt seine Versionen samt Änderungshinweisen auf, die älteste zuerst. Die Dateien werden über die Plattform heruntergeladen. Erforderlicher Scope: data-rooms:tender:read
Übersicht
API für den programmatischen Zugriff auf das GCR Portal: Teilnehmer, Bestand, Entwertung und die drei Reports des Nachweises