Skip to main content
GET
/
v1
/
contracts
/
{contract_id}
Get contract
curl --request GET \
  --url https://api.otark.energy/v1/contracts/{contract_id} \
  --header 'X-Api-Key: <api-key>'
{
  "id": "con_a1b2c3d4",
  "external_id": "PPA-2025-0042",
  "type": "ppa",
  "status": "in_progress",
  "delivery_start": "2026-01-01T00:00:00Z",
  "delivery_end": "2026-03-31T23:45:00Z",
  "seller": {
    "name": "GreenCo Energy BV",
    "eic": "11YGREENENERGY-Z",
    "tso": "TenneT"
  },
  "buyer": {
    "name": "GreenCo Energy BV",
    "eic": "11YGREENENERGY-Z",
    "tso": "TenneT"
  },
  "created_at": "2024-11-20T10:00:00Z",
  "updated_at": "2025-01-05T08:30:00Z",
  "ppa_type": "indexed",
  "period": "Q1-2026",
  "delivery_profile": "ENWEX Solar 2026",
  "asset": {
    "id": "ast_w1x2y3z4",
    "name": "Zonnepark De Wilgen",
    "nominal_power": 25,
    "technology": "solar",
    "tso": "TenneT"
  }
}

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
contract_id
string
required

Contract identifier

Example:

"con_a1b2c3d4"

Response

Contract details

An energy contract. Contracts are polymorphic — the schema varies by type.

​
id
string
required

Internal unique contract identifier

Example:

"con_a1b2c3d4"

​
external_id
string
required

External reference identifier

Example:

"PPA-2025-0042"

​
type
enum<string>
required

Contract type

Available options:
ppa,
day_ahead,
intraday
Example:

"ppa"

​
status
enum<string>
required

Contract status

Available options:
pending,
in_progress,
completed
Example:

"in_progress"

​
delivery_start
string<date-time>
required

ISO 8601 delivery start (UTC)

Example:

"2026-01-01T00:00:00Z"

​
delivery_end
string<date-time>
required

ISO 8601 delivery end (UTC)

Example:

"2026-03-31T23:45:00Z"

​
seller
object
required

A counterparty identified by EIC code

​
buyer
object
required

A counterparty identified by EIC code

​
created_at
string<date-time>
required

ISO 8601 creation timestamp

Example:

"2024-11-20T10:00:00Z"

​
updated_at
string<date-time>
required

ISO 8601 last-modified timestamp

Example:

"2025-01-05T08:30:00Z"

​
ppa_type
enum<string>

PPA pricing/delivery type (only present when type is ppa)

Available options:
forecasted,
produced,
consumed,
baseload,
shaped,
peakload,
indexed
Example:

"indexed"

​
period
string

Contract period display name (only present when type is ppa)

Example:

"Q1-2026"

​
delivery_profile
string

Delivery profile name (only present when type is ppa)

Example:

"ENWEX Solar 2026"

​
asset
object

The generating asset (only present when type is ppa)