GET /v1/counterparties/{counterparty_id}
Eine einzelne Counterparty-Verbindung über ihre Kennung abrufen. Erforderlicher Scope: rfq:read
Freischaltung erforderlich
curl -X GET "https://api.otark.com/v1/counterparties/cpt_5m8k2r6d"{
"id": "cpt_5m8k2r6d",
"company_id": "cmp_7d3f9k2a",
"company_name": "Solar Nord",
"status": "active",
"roles": [
"seller"
],
"offers_granular_certificates": true,
"contract_language": "de",
"election_sheet": true,
"general_agreement_date": "2026-05-04",
"invited_at": "2026-04-28T09:12:00Z",
"activated_at": "2026-05-04T14:30: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"
}/counterparties GET
Die Counterparty-Verbindungen des angemeldeten Unternehmens samt Verbindungsstatus auflisten. Nur aktive Counterparties in der Verkäuferrolle lassen sich als verbindliche Empfänger einer Anfrage adressieren. Erforderlicher Scope: rfq:read
/rfqs POST
Eine Anfrage anlegen. Die Anfrage geht an einen ausdrücklichen Empfängerkreis — verbindliche Empfänger sind aktive Counterparties in der Verkäuferrolle; indikative Empfänger brauchen keine Verbindung, und ihre Angebote sind nicht annehmbar. Ist granular_certificates gesetzt, darf die Anfrage nur an Verkäufer gehen, die granulare Zertifikate anbieten; jeder Empfänger sieht die Anforderung, und der mit der Annahme entstehende Einzelvertrag trägt das Merkmal GC-unterlegt. Die Empfänger werden mit dem Anlegen benachrichtigt. Ohne publication wird die Anfrage sofort veröffentlicht; mit geplanter Veröffentlichungszeit bleibt sie bis dahin scheduled. Das Angebotsfenster läuft ab der Veröffentlichung. Nach der Veröffentlichung stehen Energieträger, Lieferperiode und Leistung fest — die Verkäufer haben darauf angeboten. Die Empfängerliste steht mit dem Anlegen fest. Erforderlicher Scope: rfq:write