GET /v1/tenders
Die Ausschreibungen des angemeldeten Käuferunternehmens auflisten. Erforderlicher Scope: tenders:read
Freischaltung erforderlich
In: header
Query Parameters
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?limit=10&after=ten_a1b2c3d4"{
"tenders": [
{
"name": "Grünstrom Werk Süd 2027",
"public_name": null,
"energy_type": "mixed",
"solar_volume_per_year": 30000,
"wind_volume_per_year": 20000,
"solar_nominal_power_mw": 30,
"wind_nominal_power_mw": 10,
"solar_target_price_per_mwh": 55,
"wind_target_price_per_mwh": 65,
"delivery_start": "2027-01-01",
"contract_years_min": 5,
"contract_years_max": 10,
"consumption_zip": "84028",
"delivery_profiles": [
"pay_as_forecasted",
"pay_as_indexed"
],
"delivery_profile": "pay_as_forecasted",
"delivery": {
"current_supplier_id": "SNB912345678901",
"buyer_is_own_supplier": false,
"current_supplier_contact_name": "string",
"current_supplier_contact_email": "string",
"current_supplier_contact_phone": "string",
"notes": "string",
"seeking_new_supplier": "undecided"
},
"recipients": "public",
"invited_company_ids": [],
"excluded_company_ids": [],
"anonymous_until_admission": true,
"public_description": "Industrieller Verbraucher in Bayern sucht 50 GWh/a Solar und Wind ab 2027, 5–10 Jahre.",
"restricted_description": "Standort Werk Süd, 110-kV-Anschluss.",
"additional_fields": [
{
"label": "Min. Netzanschluss",
"value": "110 kV"
}
],
"contact_person_id": "usr_3k8m1p5r",
"scoring": {
"template_id": "industrial",
"weights": {
"effective": 40,
"ppa_price": 20,
"capture": 10,
"matching": 30,
"creditworthiness": 10,
"benchmark": 5,
"distance": 0,
"go_price": 0
},
"config": {
"property1": {
"ko_enabled": true,
"ko_threshold": 3,
"range": {
"best": 60,
"worst": 90
},
"per_tech": {
"enabled": true,
"solar": {
"ko_enabled": true,
"ko_threshold": 0,
"range": {
"best": 60,
"worst": 90
}
},
"wind": {
"ko_enabled": true,
"ko_threshold": 0,
"range": {
"best": 60,
"worst": 90
}
}
}
},
"property2": {
"ko_enabled": true,
"ko_threshold": 3,
"range": {
"best": 60,
"worst": 90
},
"per_tech": {
"enabled": true,
"solar": {
"ko_enabled": true,
"ko_threshold": 0,
"range": {
"best": 60,
"worst": 90
}
},
"wind": {
"ko_enabled": true,
"ko_threshold": 0,
"range": {
"best": 60,
"worst": 90
}
}
}
}
}
},
"load_profile_skipped": false,
"planned_publication_at": "2026-09-01T07:00:00Z",
"deadline_offers": "2026-10-13",
"deadline_signing": "2026-11-24",
"id": "ten_7g4k2m9p",
"status": "active",
"country_code": "DE",
"state": "Bayern",
"contact_person": {
"id": "usr_3k8m1p5r",
"name": "Maria Huber",
"email": "energieeinkauf@example.com"
},
"load_profile_status": "complete",
"approved_at": "2026-08-26T10:00:00Z",
"published_at": "2026-09-01T07:00:00Z",
"created_at": "2026-08-18T10:15:00Z",
"updated_at": "2026-09-01T07:00: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."
}/tenders POST
Eine Ausschreibung als Entwurf anlegen. Der Entwurf bleibt für Verkäufer unsichtbar, bis er zur Prüfung eingereicht, freigegeben und veröffentlicht ist. Pflicht beim Anlegen sind Energiequelle, Volumen je Technologie, Lieferbeginn und Laufzeitspanne; alles Übrige lässt sich später mit updateTender ergänzen. Land und Bundesland übernimmt die Plattform aus der Firmenadresse, die Postleitzahl des Verbrauchsorts ebenso als Vorbelegung. Fehlen die Fristen, setzt die Plattform ihren Vorschlag. Erforderlicher Scope: tenders:write
/tenders/{tender_id} GET
Eine Ausschreibung des angemeldeten Käuferunternehmens über ihre Kennung abrufen, samt Empfängerkreis, Fristen, Lieferung, Bewertungskriterien und Beschreibungen. Erforderlicher Scope: tenders:read