Skip to main content
GET
Get contract

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> | null
required

ISO 8601 delivery start (UTC)

Example:

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

delivery_end
string<date-time> | null
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> | null
required

ISO 8601 creation timestamp

Example:

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

ppa_type
enum<string> | null

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

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

"indexed"

period
string | null

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

Example:

"Q1-2026"

delivery_profile
string | null

Delivery profile name (only present when type is ppa)

Example:

"ENWEX Solar 2026"

asset
object

The generating asset (only present when type is ppa and an asset is assigned)