Skip to content

Market

11.1.A Explicit Allocations - Offered Transfer Capacity

GET /market/11-1-a-explicit-allocations-offered-transfer-capacity

11.1.A Explicit Allocations - Offered Transfer Capacity

GET
/market/11-1-a-explicit-allocations-offered-transfer-capacity

Request limit: Each request may cover a period of up to 1 year.

Response limit
: A maximum of 100 TimeSeries elements is returned per XML response.

Authorizations

SecurityToken
Type
API Key (query: securityToken)

Parameters

Query Parameters

documentType*

A31 = Agreed capacity

Type
string
Required
Example"A31"
auction.Type*

A02 = Explicit

Type
string
Required
Example"A02"
contract_MarketAgreement.Type*

A07 = Intraday; A01 = Day ahead; A02 = Weekly; A03 = Monthly; A08 = Quarterly; A04 = Yearly; A06 = Long Term

Type
string
Required
Example"A01"
out_Domain*

EIC code of Control Area, Bidding Zone or Bidding Zone Aggregation

Type
string
Required
Example"10YGB----------A"
in_Domain*

EIC code of Control Area, Bidding Zone or Bidding Zone Aggregation

Type
string
Required
Example"10YBE----------2"
periodStart*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202308152200"
periodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202308162200"
auction.Category

A01 = Base; A02 = Peak; A03 = Off Peak; A04 = Hourly

Type
string
Example"A04"
Update_DateAndOrTime

For Offered Capacity Evolution can be quried with datetime in numeric. For example 20210803113900000 for evolution update date time 03.08.2021 13:39:00.000

Type
integer
Example"20230313123900"
ClassificationSequence_AttributeInstanceComponent.Position

Integer

Type
integer
Example"1"

Responses

Successful response

application/xml
XML

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

11.1.B Flow Based Allocations

GET /market/11-1-b-flow-based-allocations

11.1.B Flow Based Allocations

GET
/market/11-1-b-flow-based-allocations

Request limit: Each request may cover a period of up to 1 year.

Response limit
: A maximum of 1 instances contained in the ZIP response, split into several files within the response ZIP file.

Authorizations

SecurityToken
Type
API Key (query: securityToken)

Parameters

Query Parameters

documentType*

B09 = Flow Based Domain Publication

Type
string
Required
Example"B09"
processType*

A43 = Day ahead; A44 = Intraday; A32 = Month-ahead; A33 = Year-ahead

Type
string
Required
Example"A44"
out_Domain*

EIC code of a Region

Type
string
Required
Example"10YDOM-REGION-1V"
in_Domain*

EIC code of a Region

Type
string
Required
Example"10YDOM-REGION-1V"
periodStart*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"201402032300"
periodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"201402040500"

Responses

Successful response

application/xml
XML

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

11.1.B Flow Based Allocations Archives

GET /market/11-1-b-flow-based-allocations-archives

11.1.B Flow Based Allocations Archives

GET
/market/11-1-b-flow-based-allocations-archives

Request limit: Each request may cover a period of up to 1 year.

Response limit
: A maximum of 1 archive in the ZIP response.

Authorizations

SecurityToken
Type
API Key (query: securityToken)

Parameters

Query Parameters

documentType*

B09 = Flow Based Domain Publication

Type
string
Required
Example"B09"
processType*

A43 = Day ahead; A44 = Intraday; A32 = Month-ahead; A33 = Year-ahead

Type
string
Required
Example"A32"
out_Domain*

EIC code of a Region

Type
string
Required
Example"10YDOM-REGION-1V"
in_Domain*

EIC code of a Region

Type
string
Required
Example"10YDOM-REGION-1V"
periodStart*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"201812302300"
periodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"201812312200"
StorageType*

archive

Type
string
Required
Example"archive"

Responses

Successful response

application/xml
XML

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

11.1 Continuous Allocations - Offered Transfer Capacity

GET /market/11-1-continuous-allocations-offered-transfer-capacity

11.1 Continuous Allocations - Offered Transfer Capacity

GET
/market/11-1-continuous-allocations-offered-transfer-capacity

Request limit: Each request may cover a period of up to 1 year.

Response limit
: A maximum of 100 TimeSeries elements is returned per XML response. The offsetparameter can be used to retrieve the data in batches of up to 100 TimeSeries, where offset=0 returns the first 100 elements, offset=100 returns the next 100, and so on.

Authorizations

SecurityToken
Type
API Key (query: securityToken)

Parameters

Query Parameters

DocumentType*

A31 = Agreed capacity; B33 = Published offered capacity

Type
string
Required
Example"A31"
Auction.Type*

A08 = Continuous

Type
string
Required
Example"A08"
Out_Domain*

EIC code of a Control Area, Bidding Zone or Bidding Zone Aggregation

Type
string
Required
Example"10YBE----------2"
In_Domain*

EIC code of a Control Area, Bidding Zone or Bidding Zone Aggregation

Type
string
Required
Example"10YNL----------L"
PeriodStart*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202405152200"
PeriodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202504162200"
Contract_MarketAgreement.Type*

A07 = Intraday

Type
string
Required
Example"A07"
Update_DateAndOrTime

For Offered Capacity Evolution can be quried with datetime in numeric. For example 20210803113900000 for evolution update date time 03.08.2021 13:39:00.000.

If there is no OC evolution version with requested update_DateAndOrTime the system selects OC version valid in the given time (e.g., closest previous update_DateAndOrTime). The most recent publish OC version is provided in case the update_DateAndOrTime parameter is omitted. The most recent published OC version and intermediate OC versions is distinguished by document type:
− Intermediate OC values: A31
− Most recent published OC values: B33

Type
integer
Example"20240515123900"

Responses

Successful response

application/xml
XML

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

11.1 Implicit Allocations - Offered Transfer Capacity

GET /market/11-1-implicit-allocations-offered-transfer-capacity

11.1 Implicit Allocations - Offered Transfer Capacity

GET
/market/11-1-implicit-allocations-offered-transfer-capacity

Request limit: Each request may cover a period of up to 1 year.

Response limit
: A maximum of 100 TimeSeries elements is returned per XML response.

Authorizations

SecurityToken
Type
API Key (query: securityToken)

Parameters

Query Parameters

documentType*

A31 = Agreed capacity

Type
string
Required
Example"A31"
auction.Type*

A01 = Implicit

Type
string
Required
Example"A01"
contract_MarketAgreement.Type*

A01 = Day ahead; A07 = Intraday

Type
string
Required
Example"A01"
out_Domain*

EIC code of a Control Area, Bidding Zone or Bidding Zone Aggregation

Type
string
Required
Example"10YDK-1--------W"
in_Domain*

EIC code of a Control Area, Bidding Zone or Bidding Zone Aggregation

Type
string
Required
Example"10Y1001A1001A82H"
periodStart*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202212312300"
periodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202301012300"
Update_DateAndOrTime

For Offered Capacity Evolution can be quried with datetime in numeric. For example 20210803113900000 for evolution update date time 03.08.2021 13:39:00.000

Type
integer
Example"20230313123900"
ClassificationSequence_AttributeInstanceComponent.Position

Integer

Type
integer
Example"1"

Responses

Successful response

application/xml
XML

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

12.1.A Explicit Allocations - Auction Revenue

GET /market/12-1-a-explicit-allocations-auction-revenue

12.1.A Explicit Allocations - Auction Revenue

GET
/market/12-1-a-explicit-allocations-auction-revenue

Request limit: Each request may cover a period of up to 1 year.

Response limit
: A maximum of 100 TimeSeries elements is returned per XML response.

Authorizations

SecurityToken
Type
API Key (query: securityToken)

Parameters

Query Parameters

documentType*

A25 = Allocation result document

Type
string
Required
Example"A25"
businessType*

B07 = Auction Revenue

Type
string
Required
Example"B07"
contract_MarketAgreement.Type*

A07 = Intraday; A01 = Daily; A02 = Weekly; A03 = Monthly; A08 = Quarterly; A04 = Yearly; A06 = Long Term

Type
string
Required
Example"A01"
out_Domain*

EIC code of a Control Area, Bidding Zone or a Bidding Zone Aggregation

Type
string
Required
Example"10YHR-HEP------M"
in_Domain*

EIC code of a Control Area, Bidding Zone or a Bidding Zone Aggregation

Type
string
Required
Example"10YBA-JPCC-----D"
periodStart*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202308242200"
periodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202308252200"

Responses

Successful response

application/xml
XML

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

12.1.A Explicit Allocations - Use of the Transfer Capacity

GET /market/12-1-a-explicit-allocations-use-of-the-transfer-capacity

12.1.A Explicit Allocations - Use of the Transfer Capacity

GET
/market/12-1-a-explicit-allocations-use-of-the-transfer-capacity

Request limit: Each request may cover a period of up to 1 year.

Response limit
: A maximum of 100 TimeSeries elements is returned per XML response.

Authorizations

SecurityToken
Type
API Key (query: securityToken)

Parameters

Query Parameters

documentType*

A25 = Allocation result document

Type
string
Required
Example"A25"
businessType*

A43 = Requested capacity (without price); B05 = Capacity allocated (including price)

Type
string
Required
Example"B05"
contract_MarketAgreement.Type*

A07 = Intraday; A01 = Day ahead; A02 = Weekly; A03 = Monthly; A08 = Quarterly; A04 = Yearly; A06 = Long Term

Type
string
Required
Example"A07"
out_Domain*

EIC code of a Control Area, Bidding Zone or Bidding Zone Aggregation

Type
string
Required
Example"10YGB----------A"
in_Domain*

EIC code of a Control Area, Bidding Zone or Bidding Zone Aggregation

Type
string
Required
Example"10YBE----------2"
periodStart*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202308152200"
periodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202308162200"
Auction.Category

A01 = Base; A02 = Peak; A03 = Off Peak; A04 = Hourly

Type
string
Example"A04"
ClassificationSequence_AttributeInstanceComponent.Position

Integer

Type
integer
Example"1"

Responses

Successful response

application/xml
XML

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

12.1.B Total Nominated Capacity

GET /market/12-1-b-total-nominated-capacity

12.1.B Total Nominated Capacity

GET
/market/12-1-b-total-nominated-capacity

Request limit: Each request may cover a period of up to 1 year.

Authorizations

SecurityToken
Type
API Key (query: securityToken)

Parameters

Query Parameters

documentType*

A26 = Capacity document

Type
string
Required
Example"A26"
businessType*

B08 = Total nominated capacity

Type
string
Required
Example"B08"
out_Domain*

EIC code of a Control Area or Bidding Zone

Type
string
Required
Example"10YGB----------A"
in_Domain*

EIC code of a Control Area or Bidding Zone

Type
string
Required
Example"10YBE----------2"
periodStart*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202308202200"
periodEnd

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Example"202308212200"

Responses

Successful response

application/xml
XML

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

12.1.C Total Capacity Already Allocated

GET /market/12-1-c-total-capacity-already-allocated

12.1.C Total Capacity Already Allocated

GET
/market/12-1-c-total-capacity-already-allocated

Request limit: Each request may cover a period of up to 1 year.

Response limit
: A maximum of 100 TimeSeries elements is returned per XML response.

Authorizations

SecurityToken
Type
API Key (query: securityToken)

Parameters

Query Parameters

documentType*

A26 = Capacity Document

Type
string
Required
Example"A26"
businessType*

A29 = Already Allocated Capacity

Type
string
Required
Example"A29"
contract_MarketAgreement.Type*

A07 = Intraday; A01 = Daily; A02 = Weekly; A03 = Monthly; A08 = Quarterly; A04 = Yearly; A06 = Long Term

Type
string
Required
Example"A01"
out_Domain*

EIC code of a Control Area, Bidding Zone or Bidding Zone Aggregation

Type
string
Required
Example"10YHR-HEP------M"
in_Domain*

EIC code of a Control Area, Bidding Zone or Bidding Zone Aggregation

Type
string
Required
Example"10YBA-JPCC-----D"
periodStart*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202308242200"
periodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202308252200"
auction.Category

A01 = Base; A02 = Peak; A03 = Off Peak; A04 = Hourly

Type
string
Example"A02"

Responses

Successful response

application/xml
XML

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

12.1.D Energy Prices

GET /market/12-1-d-energy-prices

12.1.D Energy Prices

GET
/market/12-1-d-energy-prices

Request limit: Each request may cover a period of up to 1 year.

Response limit
: A maximum of 100 TimeSeries elements is returned per XML response. The offsetparameter can be used to retrieve the data in batches of up to 100 TimeSeries, where offset=0 returns the first 100 elements, offset=100 returns the next 100, and so on.

Authorizations

SecurityToken
Type
API Key (query: securityToken)

Parameters

Query Parameters

documentType*

Price Document

Type
string
Required
Example"A44"
periodStart*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202407272200"
periodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202407282200"
out_Domain*

EIC code of a Bidding Zone

Type
string
Required
Example"10YAT-APG------L"
in_Domain*

EIC code of a Bidding Zone (must be same as out_Domain)

Type
string
Required
Example"10YAT-APG------L"
contract_MarketAgreement.type

A01 = Day-ahead ; A07 = Intraday

Type
string
Example"A01"
classificationSequence_AttributeInstanceComponent.position

Integer

Type
integer
Example"1"
offset

Integer: Zero‑based index of the first TimeSeries to return. The offset parameter paginates the response in batches of 100 TimeSeries (e.g., offset = n returns the TimeSeries in the range n+1 to n+100).

Type
integer
Example"0"

Responses

Successful response

application/xml
XML

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

12.1.E Implicit and Flow-based Allocations - Congestion Income

GET /market/12-1-e-implicit-and-flow-based-allocations-congestion-income

12.1.E Implicit and Flow-based Allocations - Congestion Income

GET
/market/12-1-e-implicit-and-flow-based-allocations-congestion-income

Request limit: Each request may cover a period of up to 1 year.

Response limit
: A maximum of 100 TimeSeries elements is returned per XML response.

Authorizations

SecurityToken
Type
API Key (query: securityToken)

Parameters

Query Parameters

documentType*

A25 = Allocation results

Type
string
Required
Example"A25"
businessType*

B10 = Congestion income

Type
string
Required
Example"B10"
contract_MarketAgreement.Type*

A01 = Daily; A07 = Intraday

Type
string
Required
Example"A01"
out_Domain*

EIC code of a Border (or Bidding Zone for Flow Based Allocations)

Type
string
Required
Example"10YAT-APG------L"
in_Domain*

EIC code of a Border (or Bidding Zone for Flow Based Allocations) - same as out_Domain

Type
string
Required
Example"10YAT-APG------L"
periodStart*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202308232200"
periodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202308242200"

Responses

Successful response

application/xml
XML

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

12.1.E Implicit Auction — Net Positions

GET /market/12-1-e-implicit-auction-net-positions

12.1.E Implicit Auction — Net Positions

GET
/market/12-1-e-implicit-auction-net-positions

Request limit: Each request may cover a period of up to 1 year.

Authorizations

SecurityToken
Type
API Key (query: securityToken)

Parameters

Query Parameters

documentType*

A25 = Allocation results

Type
string
Required
Example"A25"
businessType*

B09 = Net position

Type
string
Required
Example"B09"
contract_MarketAgreement.Type*

A01 = Daily; A05 = Total; A07 = Intraday

Type
string
Required
Example"A07"
out_Domain*

EIC code of a Bidding Zone or a Control Area

Type
string
Required
Example"10YBE----------2"
in_Domain*

EIC code of a Bidding Zone or a Control Area (must be same as out_Domain)

Type
string
Required
Example"10YBE----------2"
periodStart*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202308222200"
periodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202308232200"

Responses

Successful response

application/xml
XML

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

12.1.H Transfer Capacities Allocated with Third Countries [12.1.H] (explicit)

GET /market/12-1-h-transfer-capacities-allocated-with-third-countries-12-1-h-explicit

12.1.H Transfer Capacities Allocated with Third Countries [12.1.H] (explicit)

GET
/market/12-1-h-transfer-capacities-allocated-with-third-countries-12-1-h-explicit

Request limit: Each request may cover a period of up to 1 year.

Response limit
: A maximum of 100 TimeSeries elements is returned per XML response.

Authorizations

SecurityToken
Type
API Key (query: securityToken)

Parameters

Query Parameters

documentType*

A94 = Non EU allocations

Type
string
Required
Example"A94"
auction.Type*

A02 = Explicit

Type
string
Required
Example"A02"
contract_MarketAgreement.Type*

A07 = Intraday; A01 = Daily; A02 = Weekly; A03 = Monthly; A08 = Quarterly; A04 = Yearly; A06 = Long Term

Type
string
Required
Example"A07"
out_Domain*

EIC code of a Control Area, Bidding Zone, Bidding Zone Aggregation

Type
string
Required
Example"10YFI-1--------U"
in_Domain*

EIC code of a Control Area, Bidding Zone, Bidding Zone Aggregation

Type
string
Required
Example"10Y1001A1001A49F"
periodStart*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202308232200"
periodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202308242200"
auction.Category

A01 = Base; A02 = Peak; A03 = Off Peak; A04 = Hourly

Type
string
Example"A04"
classificationSequence_AttributeInstanceComponent.Position

Integer

Type
integer
Example"1"

Responses

Successful response

application/xml
XML

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI