GET /v1/rfqs/{rfq_id}/quotes
Die auf eine Anfrage eingegangenen Angebote auflisten. Verbindliche und indikative Angebote kommen gemeinsam zurück — der Filter type trennt sie. Annehmbar sind allein verbindliche Angebote; indikative dienen der Preisfindung und lassen sich nicht annehmen. Zurückgezogene Angebote werden nicht geliefert. Erforderlicher Scope: rfq:read
Freischaltung erforderlich
In: header
Path Parameters
Kennung der Anfrage
Query Parameters
Nach Angebotsart filtern
"binding" | "indicative"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/rfqs/rfq_h7t2m9c4/quotes?type=binding&limit=10&after=cpt_a1b2c3d4"{
"quotes": [
{
"id": "qte_c4x8p2n6",
"rfq_id": "rfq_h7t2m9c4",
"type": "binding",
"status": "active",
"price_per_mwh": 52.11,
"nominal_power": 10,
"estimated_delivery_volume": 4300,
"assets": [
{
"id": "ast_3p7q1z5v",
"name": "Solar Park SP-1",
"technology": "solar",
"nominal_power": 10,
"annual_production": 10400,
"mastr_number": "SEE900012345678"
}
],
"message": null,
"seller": {
"company_id": "cmp_7d3f9k2a",
"company_name": "Solar Nord"
},
"created_at": "2026-05-12T07:40:00Z"
}
],
"pagination": {
"limit": 10,
"has_more": true,
"next_cursor": "rfq_k8m2p4q7"
}
}{
"type": "https://api.otark.com/errors/validation",
"title": "Validierung fehlgeschlagen",
"status": 400,
"instance": "/v1/rfqs",
"errors": [
{
"field": "nominal_power",
"code": "value_too_small",
"message": "Nominal power must be at least 1 MW"
}
]
}{
"type": "https://api.otark.com/errors/invalid_api_key",
"title": "Ungültiger API-Schlüssel",
"status": 401
}{
"type": "https://api.otark.com/errors/insufficient_scopes",
"title": "Unzureichende Scopes des API-Schlüssels",
"status": 403,
"detail": "Missing scope: rfq:write. Please create a new API key with the required scopes."
}{
"type": "https://api.otark.com/errors/rfq_not_found",
"title": "Anfrage nicht gefunden",
"status": 404,
"instance": "/v1/rfqs/rfq_h7t2m9c4"
}/rfqs/{rfq_id}/cancel POST
Eine Anfrage abbrechen, solange sie scheduled oder active ist. Alle aktiven Angebote gehen auf not_selected, und die Verkäufer mit einem aktiven Angebot werden benachrichtigt. Eine bereits angenommene, abgelaufene oder abgebrochene Anfrage lässt sich nicht abbrechen; der Vorgang antwortet mit 409. Erforderlicher Scope: rfq:write
/quotes/{quote_id}/accept POST
Ein verbindliches Angebot annehmen. Die Annahme läuft als eine untrennbare Transaktion: Angebot und Anfrage gehen auf accepted, der Einzelvertrag entsteht mit seiner fünfstelligen Vertragsnummer und dem Merkmal GC-unterlegt aus der Anfrage, das Vertragsdokument wird erzeugt und unveränderlich archiviert, und jedes andere aktive Angebot auf die Anfrage geht auf not_selected. Die Antwort liefert den entstandenen Vertrag. Die Annahme ist möglich, solange die Anfrage active ist — veröffentlicht und vor dem Ende der Auswahlphase, 30 Minuten nach dem Ende des Angebotsfensters. Die Verbindung zwischen Käufer und Verkäufer muss im Moment der Annahme aktiv sein. **Indikative Angebote sind nicht annehmbar**; ihre Annahme antwortet mit 409. Es gibt keine Reservierung und keine Bestätigungsschleife: Die Annahme kann der Käufer nicht zurücknehmen, und der Verkäufer kann sie nicht ablehnen. Eine Anfrage erhält eine Annahme — eine Aufteilung der Menge auf mehrere Verkäufer gibt es nicht. Eine Zahlung wird nicht ausgelöst: Das Geld fließt mit der ersten Monatsrechnung des Verkäufers direkt zwischen den Parteien. Erforderlicher Scope: rfq:write