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
Freischaltung erforderlich
In: header
Path Parameters
Kennung der Ausschreibung
Query Parameters
Nach dem Zugangsstatus filtern
"invited" | "requested" | "approved" | "shortlisted" | "denied" | "cancelled"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/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"
}/tenders/{tender_id}/reopen POST
Eine geschlossene Ausschreibung wieder öffnen. Hat sie eine Freigabe der Otark GmbH, wird sie active, sonst draft. Andere Status weist die API mit 409 zurück. Erforderlicher Scope: tenders:write
/tenders/{tender_id}/access-requests/{access_id}/respond POST
Über eine Zugangsanfrage entscheiden oder einem zugelassenen Verkäufer den Zugang entziehen, solange die Ausschreibung aktiv ist (sonst 409). approved lässt einen Verkäufer mit Status requested zu: Er sieht Name und Unternehmensdaten des Käufers, den Lastgang, die Detailbeschreibung und die Anhänge, der Nachrichtenkanal entsteht, und er kann indikative Angebote abgeben. Ein eingeladener Verkäufer muss zuerst selbst Zugang anfragen (409). denied lehnt eine Anfrage ab oder entzieht einem Verkäufer mit Status approved oder shortlisted den Zugang; seine Angebote bleiben für den Käufer sichtbar. Ein nie zugelassener Verkäufer erfährt den Namen des Käufers auch mit der Ablehnung nicht. Die freiwillige Antwort (bis zu 2.000 Zeichen) steht in der E-Mail an den Verkäufer, nicht im Nachrichtenkanal. Eine Frist für die Entscheidung gibt es nicht. Erforderlicher Scope: tenders:write