Zum Hauptinhalt springen
GET
/
v1
/
transactions
/
{transaction_id}
Get transaction
curl --request GET \
  --url https://api.otark.energy/v1/transactions/{transaction_id} \
  --header 'X-Api-Key: <api-key>'
{
  "id": "txn_k8m2p4q7r1",
  "type": "ppa",
  "contract_id": "con_a1b2c3d4",
  "status": "valid",
  "version": 2,
  "sender": {
    "eic": "11YWINDPARKNO--A",
    "asset": {
      "id": "ast_w1x2y3z4",
      "name": "Zonnepark De Wilgen",
      "nominal_power": 25,
      "technology": "solar",
      "tso": "TenneT"
    },
    "tso": "TenneT"
  },
  "receiver": {
    "eic": "11YGREENENERGY-Z",
    "tso": "TenneT"
  },
  "delivery_start": "2026-01-15T14:00:00Z",
  "delivery_end": "2026-01-15T14:15:00Z",
  "slot_number": 57,
  "volume": 12.5,
  "created_at": "2026-01-14T18:00:00Z",
  "previous_transaction_id": "txn_j5n3w8v2x6"
}

Autorisierungen

​
X-Api-Key
string
header
erforderlich

Pfadparameter

​
transaction_id
string
erforderlich

Transaction identifier

Beispiel:

"txn_k8m2p4q7r1"

Antwort

Transaction details

Represents the contractual energy volumes to be transferred between buyer and seller under a contract. Transactions are immutable — corrections produce a new version that supersedes the previous one.

​
id
string
erforderlich

Unique transaction identifier

Beispiel:

"txn_k8m2p4q7r1"

​
type
enum<string>
erforderlich

Transaction type

Verfügbare Optionen:
ppa
Beispiel:

"ppa"

​
contract_id
string
erforderlich

Parent contract identifier

Beispiel:

"con_a1b2c3d4"

​
status
enum<string>
erforderlich

Transaction status

Verfügbare Optionen:
valid,
invalid,
superseded
Beispiel:

"valid"

​
version
integer
erforderlich

Version number (starts at 1, increments on correction)

Beispiel:

2

​
sender
object
erforderlich

The sending party of a transaction

​
receiver
object
erforderlich

The receiving party of a transaction

​
delivery_start
string<date-time>
erforderlich

ISO 8601 delivery period start (UTC)

Beispiel:

"2026-01-15T14:00:00Z"

​
delivery_end
string<date-time>
erforderlich

ISO 8601 delivery period end (UTC)

Beispiel:

"2026-01-15T14:15:00Z"

​
slot_number
integer
erforderlich

Quarter-hour slot number within the delivery day (1–96, or up to 100 on DST days)

Erforderlicher Bereich: 1 <= x <= 100
Beispiel:

57

​
volume
number
erforderlich

Energy volume in MWh (3 decimal places)

Beispiel:

12.5

​
created_at
string<date-time>
erforderlich

ISO 8601 creation timestamp

Beispiel:

"2026-01-14T18:00:00Z"

​
previous_transaction_id
string | null

ID of the transaction this version supersedes

Beispiel:

"txn_j5n3w8v2x6"