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
Freischaltung erforderlich
In: header
Query Parameters
Nach dem Bundesland des Käufers filtern
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/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