Tender API

GET /v1/inbox

Die Ausschreibungen auflisten, auf die das angemeldete Verkäuferunternehmen Zugang anfragen kann: veröffentlichte Ausschreibungen an alle Verkäufer, auf die es noch keinen Zugang hat, und Ausschreibungen, zu denen es eingeladen ist, auch bei invite_only — jeweils bis einschließlich des Tages der Frist für indikative Angebote. Jeder Eintrag ist anonym, auch eine Einladung: sichtbar sind Eckdaten, öffentliche Beschreibung, Fristen, Lieferprofil, ob ein Lastgang vorliegt, Bonitätsindex und Branche des Käufers. Unternehmen auf der Ausschlussliste sehen die Ausschreibung nicht. Erforderlicher Scope: tenders: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/inbox
X-Api-Key<token>

In: header

Query Parameters

state?string

Nach dem Bundesland des Käufers filtern

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/inbox?state=Bayern&limit=10&after=ten_a1b2c3d4"
{
  "tenders": [
    {
      "id": "ten_7g4k2m9p",
      "display_name": "Solar + Wind PPA - Bayern",
      "energy_type": "mixed",
      "solar_volume_per_year": 30000,
      "wind_volume_per_year": 20000,
      "solar_nominal_power_mw": 30,
      "wind_nominal_power_mw": 10,
      "delivery_start": "2027-01-01",
      "contract_years_min": 5,
      "contract_years_max": 10,
      "delivery_profile": "pay_as_forecasted",
      "deadline_offers": "2026-10-13",
      "published_at": "2026-09-01T07:00:00Z",
      "public_description": "Industrieller Verbraucher in Bayern sucht 50 GWh/a Solar und Wind ab 2027, 5–10 Jahre.",
      "state": "Bayern",
      "load_profile_available": true,
      "buyer": {
        "credit_rating": 1.5,
        "industry": "manufacturing"
      }
    }
  ],
  "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."
}

/tenders/{tender_id}/offers/{offer_id}/accept POST

Ein eingereichtes Angebot eines Verkäufers auf der Shortlist annehmen. Angebote anderer Verkäufer weist die API mit 409 zurück, ebenso abgelehnte und zurückgezogene. Der Käufer kann mehrere Angebote annehmen, auch mehrere desselben Verkäufers; eine erneute Annahme desselben Angebots ändert nichts. Die Annahme legt fest, auf welches Angebot sich der unterzeichnete PPA bezieht. Sie erzeugt weder einen Vertrag noch ein Dokument. Danach ist das Angebot unveränderlich: Der Verkäufer kann es weder zurückziehen noch überarbeiten und die Ausschreibung nicht mehr verlassen, der Käufer kann es weder ablehnen noch Änderungen anfragen. Bei einem Angebot mit Abschlag schreibt die Annahme die Preise fest. Der Verkäufer erhält eine E-Mail. Erforderlicher Scope: tenders:sign

/tenders/{tender_id}/application POST

Als Verkäufer Zugang zu einer Ausschreibung anfragen — auf eine Ausschreibung an alle Verkäufer oder auf eine Einladung, auch bei invite_only. Die freiwillige Nachricht (bis zu 2.000 Zeichen) liest der Käufer zusammen mit dem Unternehmensprofil — Name, Adresse, Technologie, Gründungsjahr, Portfolio, Märkte und Bonitätsindex. Verkäufer sind gegenüber dem Käufer nie anonym. Der Zugang wechselt auf requested; der Käufer entscheidet. Anfragen kann nur ein verifiziertes Unternehmen (403), nur bei einer veröffentlichten Ausschreibung aus der eigenen Tender Inbox und nur bis einschließlich des Tages der Frist für indikative Angebote (403). Eine zweite Anfrage weist die API mit 409 zurück. Erforderlicher Scope: tenders:offer