1-Click PPA API

POST /v1/rfqs/{rfq_id}/cancel

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

Als Markdown anzeigen

Freischaltung erforderlich

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

In: header

Path Parameters

rfq_idstring

Kennung der Anfrage

Response Body

curl -X POST "https://api.otark.com/v1/rfqs/rfq_h7t2m9c4/cancel"
{
  "id": "rfq_h7t2m9c4",
  "status": "active",
  "energy_source": "solar",
  "reference_index": "ENWEX Solar DE",
  "delivery_period": {
    "id": "2026-Q3",
    "type": "quarter",
    "display_name": "Q3 2026",
    "delivery_start": "2026-07-01",
    "delivery_end": "2026-09-30"
  },
  "nominal_power": 10,
  "max_nominal_power_deviation": 10,
  "granular_certificates": true,
  "estimated_delivery_volume": 4300,
  "quoting_window_minutes": 480,
  "publication": "2026-05-12T07:00:00Z",
  "expires_at": "2026-05-12T15:00:00Z",
  "recipients": [
    {
      "company_id": "cmp_7d3f9k2a",
      "company_name": "Solar Nord",
      "type": "binding",
      "status": "quoted",
      "decline_reason": null
    }
  ],
  "accepted_quote_id": null,
  "contract_number": null,
  "created_at": "2026-05-12T07:00:00Z"
}

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

{
  "type": "https://api.otark.com/errors/indicative_quote_not_acceptable",
  "title": "Indikatives Angebot nicht annehmbar",
  "status": 409,
  "detail": "Indicative quotes cannot be accepted. Only binding quotes can be accepted."
}