1-Click PPA API

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

Als Markdown anzeigen

Freischaltung erforderlich

Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
GET
/v1/rfqs/{rfq_id}/quotes
X-Api-Key<token>

In: header

Path Parameters

rfq_idstring

Kennung der Anfrage

Query Parameters

type?string

Nach Angebotsart filtern

Value in"binding" | "indicative"
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/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