1-Click PPA API

GET /v1/contracts/{contract_number}

Einen einzelnen Einzelvertrag über seine Vertragsnummer abrufen, samt dem Link auf das archivierte Vertragsdokument und dem Merkmal GC-unterlegt. 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/{contract_number}
X-Api-Key<token>

In: header

Path Parameters

contract_numberstring

Vertragsnummer (fünf Zeichen, Großbuchstaben und Ziffern)

Response Body

curl -X GET "https://api.otark.com/v1/contracts/7K2QP"
{
  "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"
}

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