GET /v1/tenders/{tender_id}/offers
Die Angebote der Ausschreibung auflisten. Der Käufer sieht alle Angebote, jedes mit seiner Bewertung (score) gegen die Bewertungskriterien: Werte und Punkte je Kriterium, den gewichteten Gesamtscore 0–100 und die Bewertungsstufe. Ein Verkäufer erhält mit demselben Aufruf nur seine eigenen Angebote, ohne Bewertung; Rang und Punkte sieht er nie. Zurückgezogene und abgelehnte Angebote bleiben mit ihrem Status gelistet; eine Revision ersetzt ihren Vorgänger. Erforderlicher Scope: tenders:read
Freischaltung erforderlich
In: header
Path Parameters
Kennung der Ausschreibung
Query Parameters
Nach Technologie filtern
"solar" | "wind"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/ten_7g4k2m9p/offers?technology=solar&limit=10&after=ten_a1b2c3d4"{
"offers": [
{
"pricing_model": "fixed",
"price_schedule": "flat",
"price_per_mwh": 54.5,
"period_discounts": [
{
"key": "cal-2027",
"discount_percent": 36
}
],
"year_prices": [
{
"year": 2027,
"price_per_mwh": 54.5
}
],
"price_per_go": 0.8,
"id": "ten_off_8m2p6r9t",
"tender_id": "ten_7g4k2m9p",
"seller_company_id": "com_9k3m7p2r",
"technology": "solar",
"status": "submitted",
"accepted_at": null,
"start_date": "2027-01-01",
"contract_years": 10,
"end_date": null,
"delivery_profile": "pay_as_forecasted",
"price_index": null,
"volume_per_year": 31500,
"capacity_mw": 30,
"discount_percent": null,
"price_periods": [
{
"key": "cal-2027",
"period_start": "2027-01-01",
"period_end": "2027-12-31",
"partial": false,
"discount_percent": 36,
"future_price": 85,
"price_per_mwh": 54.4
}
],
"price_settlement_date": "2026-10-09",
"offer_message": "Profil 2023–2025 ist die reale Einspeisung.",
"assets": [
{
"id": "ast_1w4y7z2c",
"name": "Solarpark Niederbayern",
"mastr_number": "SEE931570002846",
"technology": "solar",
"capacity_mw": 30
}
],
"production_profile_available": true,
"replaces_offer_id": null,
"score": {
"composite": 76,
"rating": "recommended",
"ko": false,
"ko_criteria": [],
"completeness": 1,
"seller_completeness": 1,
"criteria": [
{
"key": "capture",
"value": 86,
"score": 0,
"missing": null
}
]
},
"submitted_at": "2026-10-10T14:20:00Z",
"created_at": "2026-10-10T14:20: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}/shortlist POST
Einen zugelassenen Verkäufer auf die Shortlist setzen (Zugangsstatus shortlisted) oder wieder herunternehmen (approved), solange die Ausschreibung aktiv ist. Ein Angebot braucht es dafür nicht, eine Frist gibt es nicht. Die Shortlist öffnet den Datenraum, und der Käufer kann die Angebote des Verkäufers annehmen. Wer von der Shortlist genommen wird, sieht den Datenraum nicht mehr. Freiwillig nennt der Käufer die Angebote, auf denen der Eintrag beruht (bis zu 50, eigene Angebote des Verkäufers, nicht abgelehnt oder zurückgezogen). Die Annahme eines Angebots hängt nicht an dieser Auswahl. Erforderlicher Scope: tenders:write
/tenders/{tender_id}/offer-requests POST
Einen zugelassenen Verkäufer (approved oder shortlisted, sonst 409) um ein neues indikatives Angebot bitten oder an eines erinnern. Der Verkäufer erhält eine E-Mail; die freiwillige Nachricht steht zusätzlich im Nachrichtenkanal. Dieselbe Anfrage an denselben Verkäufer ist frühestens sieben Tage (7 × 24 Stunden) nach der letzten möglich, vorher antwortet die API mit 409. Erforderlicher Scope: tenders:write