Tender API

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

Als Markdown anzeigen

Freischaltung erforderlich

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

In: header

Path Parameters

tender_idstring

Kennung der Ausschreibung

Query Parameters

company_id?string

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.

limit?integer

Höchstzahl der Einträge pro Seite

Default10
Range1 <= value <= 100
after?string

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