GET /v1/tenders/{tender_id}
Eine Ausschreibung des angemeldeten Käuferunternehmens über ihre Kennung abrufen, samt Empfängerkreis, Fristen, Lieferung, Bewertungskriterien und Beschreibungen. Erforderlicher Scope: tenders:read
Freischaltung erforderlich
curl -X GET "https://api.otark.com/v1/tenders/ten_7g4k2m9p"{
"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"
}{
"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 GET
Die Ausschreibungen des angemeldeten Käuferunternehmens auflisten. Erforderlicher Scope: tenders:read
/tenders/{tender_id} PATCH
Felder einer eigenen Ausschreibung ändern; nicht übergebene Felder bleiben unverändert. **Einladungs- und Ausschlussliste** lassen sich nur im Entwurf ändern (TENDER_AUDIENCE_LOCKED); danach lädt der Käufer einzeln mit inviteSeller ein. **Fristen:** Eine Frist darf nie in der Vergangenheit liegen, heute ist zulässig (TENDER_DEADLINE_OFFERS_PAST, TENDER_DEADLINE_SIGNING_PAST). Eine noch laufende Frist darf früher oder später gelegt werden. Ist eine Frist nach der Veröffentlichung abgelaufen, lässt sie sich nicht mehr ändern (TENDER_DEADLINE_OFFERS_LOCKED, TENDER_DEADLINE_SIGNING_LOCKED). Der Geplante PPA-Abschluss liegt nach der Frist für indikative Angebote und vor dem Lieferbeginn (TENDER_DEADLINE_SIGNING_BEFORE_OFFERS, TENDER_DEADLINE_SIGNING_AFTER_DELIVERY); die geplante Veröffentlichung liegt nicht nach dem Tag der Frist für indikative Angebote (PUBLICATION_DEADLINE_CONFLICT). **Wesentliche Änderungen:** Ändert der Käufer an einer veröffentlichten Ausschreibung Fristen, Empfängerkreis, Anonymität, Detailbeschreibung oder Veröffentlichungszeitpunkt, benachrichtigt die Plattform die zugelassenen Verkäufer. Alle übrigen Änderungen sind sofort sichtbar, ohne Benachrichtigung. Bewertungskriterien bleiben änderbar; die Bewertungen werden neu berechnet. Erforderlicher Scope: tenders:write