Tender API

GET /v1/tenders/{tender_id}/access-requests

Jede Zugangsbeziehung der Ausschreibung auflisten — offene Einladungen und Anfragen, zugelassene Verkäufer und solche auf der Shortlist, abgelehnte und zurückgezogene —, filterbar nach Status. Jeder Eintrag zeigt den Verkäufer mit Namen und Kurzprofil: Verkäufer sind gegenüber dem Käufer nie anonym. 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}/access-requests
X-Api-Key<token>

In: header

Path Parameters

tender_idstring

Kennung der Ausschreibung

Query Parameters

status?string

Nach dem Zugangsstatus filtern

Value in"invited" | "requested" | "approved" | "shortlisted" | "denied" | "cancelled"
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/access-requests?status=invited&limit=10&after=ten_a1b2c3d4"
{
  "accesses": [
    {
      "id": "ten_acc_2f6h9k3m",
      "tender_id": "ten_7g4k2m9p",
      "seller_company": {
        "id": "com_9k3m7p2r",
        "name": "Solar Nord",
        "founded_year": 2019,
        "portfolio_mw": 85,
        "credit_rating": 1.8
      },
      "status": "approved",
      "origin": "application",
      "request_message": "Solarpark in Niederbayern, 30 MW, seit 2024 in Betrieb, Erzeugungsdaten liegen vor.",
      "response_message": "Bitte bis zur Frist auch das Erzeugungsprofil hochladen.",
      "anchor_offer_ids": [],
      "requested_at": "2026-09-05T08:42:00Z",
      "admitted_at": "2026-09-08T09:12:00Z",
      "created_at": "2026-09-05T08:42:00Z",
      "updated_at": "2026-09-08T09:12:00Z"
    }
  ],
  "pagination": {
    "limit": 10,
    "has_more": true,
    "next_cursor": "ten_off_k8m2p4q7"
  }
}

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