1-Click PPA API

GET /v1/contracts

Die Einzelverträge des angemeldeten Unternehmens auflisten — als Käufer und als Verkäufer, der neueste zuerst. Erforderlicher Scope: contracts: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/contracts
X-Api-Key<token>

In: header

Query Parameters

status?string

Nach Lieferstatus filtern

Value in"pending" | "in_progress" | "completed"
energy_source?string

Nach Energieträger filtern

Value in"solar" | "wind"
gc_backed?string

Nach dem Merkmal GC-unterlegt filtern

Value in"true" | "false"
role?string

Nach der Rolle des angemeldeten Unternehmens im Vertrag filtern

Value in"buyer" | "seller"
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/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."
}