Tender API

GET /v1/tenders

Die Ausschreibungen des angemeldeten Käuferunternehmens auflisten. 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
X-Api-Key<token>

In: header

Query Parameters

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