Tender API

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

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}
X-Api-Key<token>

In: header

Path Parameters

tender_idstring

Kennung der Ausschreibung

Response Body

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"
}