Tender API

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

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}/messages
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/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