GET /v1/contracts
Die Einzelverträge des angemeldeten Unternehmens auflisten — als Käufer und als Verkäufer, der neueste zuerst. Erforderlicher Scope: contracts:read
Freischaltung erforderlich
In: header
Query Parameters
Nach Lieferstatus filtern
"pending" | "in_progress" | "completed"Nach Energieträger filtern
"solar" | "wind"Nach dem Merkmal GC-unterlegt filtern
"true" | "false"Nach der Rolle des angemeldeten Unternehmens im Vertrag filtern
"buyer" | "seller"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/contracts?status=pending&energy_source=solar&gc_backed=true&role=buyer&limit=10&after=cpt_a1b2c3d4"{
"contracts": [
{
"contract_number": "7K2QP",
"status": "in_progress",
"role": "buyer",
"buyer": {
"company_id": "cmp_9s4w2e8b",
"company_name": "Stadtwerke"
},
"seller": {
"company_id": "cmp_7d3f9k2a",
"company_name": "Solar Nord"
},
"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,
"price_per_mwh": 52.11,
"gc_backed": true,
"assets": [
{
"id": "ast_3p7q1z5v",
"name": "Solar Park SP-1",
"technology": "solar",
"nominal_power": 10,
"annual_production": 10400,
"mastr_number": "SEE900012345678"
}
],
"general_agreement_date": "2026-05-04",
"concluded_at": "2026-05-12T08:42:17Z",
"document_url": "https://api.otark.com/v1/contracts/7K2QP/document"
}
],
"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."
}/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
/contracts/{contract_number} GET
Einen einzelnen Einzelvertrag über seine Vertragsnummer abrufen, samt dem Link auf das archivierte Vertragsdokument und dem Merkmal GC-unterlegt. Erforderlicher Scope: contracts:read