POST /v1/tenders/{tender_id}/messages
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
Freischaltung erforderlich
In: header
Path Parameters
Kennung der Ausschreibung
Nachrichtentext (bis zu 2.000 Zeichen)
Nur für Käufer: das Verkäuferunternehmen, in dessen Kanal geschrieben wird
Angehängte Dateien (bis zu 5, je 30 MB)
Response Body
curl -X POST "https://api.otark.com/v1/tenders/ten_7g4k2m9p/messages" \ -F content="Bitte bis zur Frist auch das Erzeugungsprofil hochladen."{
"id": "msg_7h1k4n8q",
"tender_id": "ten_7g4k2m9p",
"sender_company_id": "com_4b8d2f6h",
"sender_role": "buyer",
"content": "Bitte bis zur Frist auch das Erzeugungsprofil hochladen.",
"attachments": [
{
"file_name": "Erzeugungsprofil-2023-2025.csv",
"size_bytes": 1848320
}
],
"created_at": "2026-09-09T09:12: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_not_found",
"title": "Ausschreibung nicht gefunden",
"status": 404,
"error": "TENDER_NOT_FOUND",
"instance": "/v1/tenders/ten_7g4k2m9p"
}/tenders/{tender_id}/messages GET
Die Nachrichten des Kanals zwischen dem Käufer und einem zugelassenen Verkäufer auflisten. Jede Ausschreibung hat je zugelassenem Verkäufer einen Kanal: Der Käufer spricht einen Kanal über company_id an; ein Verkäufer liest seinen eigenen Kanal und lässt den Parameter weg. Der Kanal entsteht leer mit der Zulassung. Im Kanal stehen auch die Nachrichten des Käufers zu Angebotsanfragen, Änderungsanfragen und Ablehnungen. Erforderlicher Scope: chats:read
/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