Tender API

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

Als Markdown anzeigen

Freischaltung erforderlich

Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
GET
/v1/tenders/{tender_id}/offers
X-Api-Key<token>

In: header

Path Parameters

tender_idstring

Kennung der Ausschreibung

Query Parameters

technology?string

Nach Technologie filtern

Value in"solar" | "wind"
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/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"
}