GET /v1/tenders/{tender_id}/data-room/documents
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
Freischaltung erforderlich
In: header
Path Parameters
Kennung der Ausschreibung
Query Parameters
Nur für Käufer: das Verkäuferunternehmen, dessen Kanal oder Datenraum angesprochen wird — der Käufer hat je zugelassenem Verkäufer einen Kanal und je Verkäufer auf der Shortlist einen Datenraum. Verkäufer lassen diesen Parameter weg; gemeint ist dann ihr eigener Kanal oder Raum.
Höchstzahl der Einträge pro Seite
101 <= value <= 100Cursor für die nächste Seite — den Wert next_cursor aus der vorherigen Antwort übergeben
Response Body
curl -X GET "https://api.otark.com/v1/tenders/ten_7g4k2m9p/data-room/documents?company_id=com_9k3m7p2r&limit=10&after=ten_a1b2c3d4"{
"documents": [
{
"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"
}
],
"pagination": {
"limit": 10,
"has_more": true,
"next_cursor": "ten_off_k8m2p4q7"
}
}{
"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}/messages POST
Eine Nachricht in den Kanal zwischen dem Käufer und einem zugelassenen Verkäufer senden. Der Nachrichtentext fasst bis zu 2.000 Zeichen; anhängen lassen sich bis zu 5 Dateien von je 30 MB. Der Käufer spricht einen Kanal an, indem er die company_id des Verkäufers als Formularfeld übergibt; ein Verkäufer schreibt in seinen eigenen Kanal und lässt sie weg. Über ungelesene Nachrichten wird die Gegenseite per E-Mail benachrichtigt. Erforderlicher Scope: chats:write
/tenders/{tender_id}/data-room/documents POST
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