GET /v1/tenders/{tender_id}/messages
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
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/messages?company_id=com_9k3m7p2r&limit=10&after=ten_a1b2c3d4"{
"messages": [
{
"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"
}
],
"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_not_found",
"title": "Ausschreibung nicht gefunden",
"status": 404,
"error": "TENDER_NOT_FOUND",
"instance": "/v1/tenders/ten_7g4k2m9p"
}/tenders/{tender_id}/signed-ppas POST
Einen außerhalb der Plattform unterzeichneten PPA erfassen, mit Bezug auf ein angenommenes Angebot. Erfassen kann der Verkäufer oder der Käufer; der Käufer nennt dabei den Verkäufer (counterparty_company_id, sonst COUNTERPARTY_REQUIRED). Voraussetzung ist ein Verkäufer auf der Shortlist (SHORTLISTED_ACCESS_REQUIRED) und ein angenommenes Angebot dieses Verkäufers in dieser Ausschreibung (OFFER_REQUIRED, OFFER_MISMATCH). Die Angaben entsprechen dem unterzeichneten Vertrag; der Vertrag selbst wird als PDF bis 50 MB hochgeladen (CONTRACT_MUST_BE_PDF) und ist für beide Seiten sichtbar. Das Erfassen ist eine Erklärung, keine Prüfung: Die Gegenseite bestätigt nichts, und die Otark GmbH prüft den Vertrag nicht. Der erste erfasste PPA schließt die Ausschreibung; zu weiteren angenommenen Angeboten lassen sich danach noch PPAs erfassen. Der PPA erscheint bei beiden Seiten unter den laufenden PPAs. Erforderlicher Scope: tenders:sign (Käufer) oder tenders:offer (Verkäufer)
/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