Tender API

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

Als Markdown anzeigen

Freischaltung erforderlich

Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
POST
/v1/tenders/{tender_id}/data-room/documents
X-Api-Key<token>

In: header

Path Parameters

tender_idstring

Kennung der Ausschreibung

filestring

Die hochzuladende Datei (beliebiger Typ, bis 500 MB)

company_id?string

Nur für Käufer: der Verkäufer auf der Shortlist, in dessen Datenraum hochgeladen wird

document_id?string

Vorhandenes Dokument, dem eine neue Version hinzugefügt wird; bleibt die Angabe weg, entsteht ein neues Dokument

category?string

Kategorie des Dokuments (für neue Dokumente; Voreinstellung contract)

Value in"contract" | "technical" | "commercial" | "corporate" | "financial" | "permits"
change_note?string

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"
}