Tender API

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

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}/messages
X-Api-Key<token>

In: header

Path Parameters

tender_idstring

Kennung der Ausschreibung

contentstring

Nachrichtentext (bis zu 2.000 Zeichen)

company_id?string

Nur für Käufer: das Verkäuferunternehmen, in dessen Kanal geschrieben wird

attachments?array<string>

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