Skip to content

Outages ​

10.1.A&B Unavailability of Transmission Infrastructure ​

GET /outages/10-1-a-b-unavailability-of-transmission-infrastructure

10.1.A&B Unavailability of Transmission Infrastructure​

GET
/outages/10-1-a-b-unavailability-of-transmission-infrastructure

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

  • It applies to PeriodStart and PeriodEnd if PeriodStartUpdate and PeriodEndUpdate parameters are not included in the request.

  • It applies only to PeriodStartUpdate and PeriodEndUpdate if included in the request.

Response limit: A maximum of 200 XML documents contained in the ZIP response. The offsetparameter can be used to retrieve the data in batches of up to 200 XML documents, where offset=0 returns the first 200 documents, offset=200 returns the next 200, and so on.

Authorizations​

SecurityToken
Type
API Key (query: securityToken)

Parameters​

Query Parameters

documentType*

A78 = Transmission unavailability

Type
string
Required
Example"A78"
Out_Domain*

Control Area, Bidding Zone (optional if mRID is present)

Type
string
Required
Example"10YFR-RTE------C"
In_Domain*

Control Area, Bidding Zone (optional if mRID is present)

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

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202312012300"
periodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202312022300"
BusinessType

A53 = Planned maintenance; A54 = Forced unavailability (unplanned outage)

Type
string
Example"A53"
DocStatus

DocStatus (when not defined only Active and Cancelled outages are returned)
A05 = Active
A09 = Cancelled
A13 = Withdrawn

Type
string
Example"A05"
PeriodStartUpdate

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Example"202111090000"
PeriodEndUpdate

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Example"202112212300"
mRID

Used to retrieve previous outage versions

Type
string
Example"A47mJe5e9jml9FeSL6jfKg"
offset

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

Type
integer
Example"0"

Responses​

Successful response

application/xml
XML

Playground​

Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

10.1.A&B Unavailability of Transmission Infrastructure - Available Capacity ​

GET /outages/10-1-a-b-unavailability-of-transmission-infrastructure-available-capacity

10.1.A&B Unavailability of Transmission Infrastructure - Available Capacity​

GET
/outages/10-1-a-b-unavailability-of-transmission-infrastructure-available-capacity

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

  • It applies to PeriodStart and PeriodEnd if PeriodStartUpdate and PeriodEndUpdate parameters are not included in the request.

  • It applies only to PeriodStartUpdate and PeriodEndUpdate if included in the request.

Response limit: A maximum of 200 XML documents contained in the ZIP response. The offsetparameter can be used to retrieve the data in batches of up to 200 XML documents, where offset=0 returns the first 200 documents, offset=200 returns the next 200, and so on.

Authorizations​

SecurityToken
Type
API Key (query: securityToken)

Parameters​

Query Parameters

documentType*

A78 = Transmission unavailability

Type
string
Required
Example"A78"
ControlArea_Domain*

Control Area, Bidding Zone (optional if mRID is present)

Type
string
Required
Example"10YFR-RTE------C"
periodStart*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202312012300"
periodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202312022300"
BusinessType

A53 = Planned maintenance; A54 = Forced unavailability (unplanned outage)

Type
string
Example"A53"
Asset_RegisteredResource.mRID

EIC code of a Transmission Asset

Type
string
DocStatus

DocStatus (when not defined only Active and Cancelled outages are returned)
A05 = Active
A09 = Cancelled
A13 = Withdrawn

Type
string
Example"A05"
PeriodStartUpdate

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Example"202111090000"
PeriodEndUpdate

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Example"202112212300"
mRID

Used to retrieve previous outage versions

Type
string
Example"A47mJe5e9jml9FeSL6jfKg"
offset

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

Type
integer
Example"0"

Responses​

Successful response

application/xml
XML

Playground​

Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

10.1.A&B Unavailability of Transmission Infrastructure - Net Position Impact ​

GET /outages/10-1-a-b-unavailability-of-transmission-infrastructure-net-position-impact

10.1.A&B Unavailability of Transmission Infrastructure - Net Position Impact​

GET
/outages/10-1-a-b-unavailability-of-transmission-infrastructure-net-position-impact

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

  • It applies to PeriodStart and PeriodEnd if PeriodStartUpdate and PeriodEndUpdate parameters are not included in the request.

  • It applies only to PeriodStartUpdate and PeriodEndUpdate if included in the request.

Response limit: A maximum of 200 XML documents contained in the ZIP response. The offsetparameter can be used to retrieve the data in batches of up to 200 XML documents, where offset=0 returns the first 200 documents, offset=200 returns the next 200, and so on.

Authorizations​

SecurityToken
Type
API Key (query: securityToken)

Parameters​

Query Parameters

documentType*

A78 = Transmission unavailability

Type
string
Required
Example"A78"
pTDF_Domain.mRID*

Control Area, Bidding Zone (optional if mRID is present)

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

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202312012300"
periodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202312022300"
BusinessType

A53 = Planned maintenance; A54 = Forced unavailability (unplanned outage)

Type
string
Example"A53"
DocStatus

DocStatus (when not defined only Active and Cancelled outages are returned)
A05 = Active
A09 = Cancelled
A13 = Withdrawn

Type
string
Example"A05"
PeriodStartUpdate

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Example"202111090000"
PeriodEndUpdate

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Example"202112212300"
mRID

Used to retrieve previous outage versions

Type
string
Example"A47mJe5e9jml9FeSL6jfKg"
offset

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

Type
integer
Example"0"
Asset_RegisteredResource.mRID

EIC Code of the Transmission Asset

Type
string

Responses​

Successful response

application/xml
XML

Playground​

Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

10.1.C Unavailability of Offshore Grid Infrastructure ​

GET /outages/10-1-c-unavailability-of-offshore-grid-infrastructure

10.1.C Unavailability of Offshore Grid Infrastructure​

GET
/outages/10-1-c-unavailability-of-offshore-grid-infrastructure

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

  • It applies to PeriodStart and PeriodEnd if PeriodStartUpdate and PeriodEndUpdate parameters are not included in the request.

  • It applies only to PeriodStartUpdate and PeriodEndUpdate if included in the request.

Response limit: A maximum of 200 XML documents contained in the ZIP response. The offsetparameter can be used to retrieve the data in batches of up to 200 XML documents, where offset=0 returns the first 200 documents, offset=200 returns the next 200, and so on.

Authorizations​

SecurityToken
Type
API Key (query: securityToken)

Parameters​

Query Parameters

documentType*

A79 = Offshore grid infrastructure unavailability

Type
string
Required
Example"A79"
BiddingZone_Domain*

EIC code of a Control Area, Bidding Zone (optional if mRID is present)

Type
string
Required
Example"10Y1001A1001A82H"
periodStart*

Pattern yyyyMMddHHmm e.g. 201601010000 (optional if PeriodStartUpdate is defined)

Type
integer
Required
Example"202301142300"
periodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000 (optional if PeriodEndUpdate is defined)

Type
integer
Required
Example"202301152300"
DocStatus

DocStatus (when not defined only Active and Cancelled outages are returned) - A05 = Active; A09 = Cancelled; A13 = Withdrawn

Type
string
Example"A05"
PeriodStartUpdate

Pattern yyyyMMddHHmm e.g. 201601010000 (mandatory if PeriodStart and PeriodEnd are not defined)

Type
integer
Example"202312010000"
PeriodEndUpdate

Pattern yyyyMMddHHmm e.g. 201601010000 (mandatory if PeriodStart and PeriodEnd are not defined)

Type
integer
Example"202312020000"
mRID

Used to retrieve previous outage versions

Type
string
offset

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

Type
integer
Example"0"

Responses​

Successful response

application/xml
XML

Playground​

Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

15.1.A&B Unavailability of Generation Units ​

GET /outages/15-1-a-b-unavailability-of-generation-units

15.1.A&B Unavailability of Generation Units​

GET
/outages/15-1-a-b-unavailability-of-generation-units

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

  • It applies to PeriodStart and PeriodEnd if PeriodStartUpdate and PeriodEndUpdate parameters are not included in the request.

  • It applies only to PeriodStartUpdate and PeriodEndUpdate if included in the request.

Response limit: A maximum of 200 XML documents contained in the ZIP response. The offsetparameter can be used to retrieve the data in batches of up to 200 XML documents, where offset=0 returns the first 200 documents, offset=200 returns the next 200, and so on.

Authorizations​

SecurityToken
Type
API Key (query: securityToken)

Parameters​

Query Parameters

documentType*

A80 = Generation unavailability

Type
string
Required
Example"A80"
BiddingZone_Domain*

Control Area, Bidding Zone (optional if mRID is present)

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

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202301022200"
periodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202401022200"
BusinessType

A53 = Planned maintenance; A54 = Forced unavailability (unplanned outage)

Type
string
Example"A53"
DocStatus

DocStatus (when not defined only Active and Cancelled outages are returned): A05 = Active; A09 = Cancelled; A13 = Withdrawn

Type
string
Example"A05"
PeriodStartUpdate

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Example"202301031000"
PeriodEndUpdate

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Example"202301032200"
RegisteredResource

EIC Code of Generation Unit

Type
string
Example"22WCOOX6X000064W"
mRID

Used to retrieve older versions of an outage

Type
string
Example"nCYGn4HPvOBiVrWtRFL35g"
offset

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

Type
integer
Example"0"

Responses​

Successful response

application/xml
XML

Playground​

Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

15.1.C-D Unavailability of Production Units ​

GET /outages/15-1-c-d-unavailability-of-production-units

15.1.C-D Unavailability of Production Units​

GET
/outages/15-1-c-d-unavailability-of-production-units

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

  • It applies to PeriodStart and PeriodEnd if PeriodStartUpdate and PeriodEndUpdate parameters are not included in the request.

  • It applies only to PeriodStartUpdate and PeriodEndUpdate if included in the request.

Response limit: A maximum of 200 XML documents contained in the ZIP response. The offsetparameter can be used to retrieve the data in batches of up to 200 XML documents, where offset=0 returns the first 200 documents, offset=200 returns the next 200, and so on.

Authorizations​

SecurityToken
Type
API Key (query: securityToken)

Parameters​

Query Parameters

documentType*

A77 = Production unit unavailability

Type
string
Required
Example"A77"
BiddingZone_Domain*

EIC code of a Control Area, Bidding Zone (optional if mRID is present)

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

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202212312300"
periodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Required
Example"202301312300"
BusinessType

A53 = Planned maintenance; A54 = Forced unavailability (unplanned outage)

Type
string
Example"A53"
DocStatus

A05 = Active; A09 = Cancelled; A13 = Withdrawn; (when not defined only Active and Cancelled outages are returned)

Type
string
Example"A05"
PeriodStartUpdate

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Example"202301152300"
PeriodEndUpdate

Pattern yyyyMMddHHmm e.g. 201601010000

Type
integer
Example"202301312300"
RegisteredResource

EIC Code of Production Unit

Type
string
Example"22W20200608A---8"
mRID

Older versions of an outage is returned only when mRID parameter is used

Type
string
Example"-WmcUg9Da9u8AF3A_gx8UQ"
offset

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

Type
integer
Example"1"

Responses​

Successful response

application/xml
XML

Playground​

Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

7.1.A-B Aggregated Unavailability of Consumption Units ​

GET /outages/7-1-a-b-aggregated-unavailability-of-consumption-units

7.1.A-B Aggregated Unavailability of Consumption Units​

GET
/outages/7-1-a-b-aggregated-unavailability-of-consumption-units

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

Authorizations​

SecurityToken
Type
API Key (query: securityToken)

Parameters​

Query Parameters

documentType*

A76 = Load unavailability

Type
string
Required
Example"A76"
BiddingZone_Domain*

EIC code of a Control Area or a Bidding Zone (optional if mRID is present)

Type
string
Required
Example"10Y1001A1001A82H"
periodStart*

Pattern yyyyMMddHHmm e.g. 201601010000 (optional if PeriodStartUpdate is defined)

Type
integer
Required
Example"202310312300"
periodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000 (optional if PeriodEndUpdate is defined)

Type
integer
Required
Example"202311302300"
BusinessType

A53 = Planned maintenance; A54 = Forced unavailability (unplanned outage)

Type
string
Example"A53"

Responses​

Successful response

application/xml
XML

Playground​

Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

Fall-backs [IFs IN 7.2, mFRR 3.11, aFRR 3.10] ​

GET /outages/fall-backs-ifs-in-7-2-mfrr-3-11-afrr-3-10

Fall-backs [IFs IN 7.2, mFRR 3.11, aFRR 3.10]​

GET
/outages/fall-backs-ifs-in-7-2-mfrr-3-11-afrr-3-10

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

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

Authorizations​

SecurityToken
Type
API Key (query: securityToken)

Parameters​

Query Parameters

documentType*

A53 = Outage publication document

Type
string
Required
Example"A53"
ProcessType*

A47 = Manual frequency restoration reserve; A51 = Automatic frequency restoration reserve; A63 = Imbalance Netting

Type
string
Required
Example"A51"
BusinessType*

C47 = Disconnection; A53 = Planned maintenance; A54: Unplanned outage; A83 = Auction cancellation (used in case no solution found or algorithm failure)

Type
string
Required
Example"C47"
BiddingZone_Domain*

EIC code of a CTA/LFA/REG

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

Pattern yyyyMMddHHmm e.g. 201601010000 (optional if PeriodStartUpdate is defined)

Type
integer
Required
Example"202301010000"
periodEnd*

Pattern yyyyMMddHHmm e.g. 201601010000 (optional if PeriodEndUpdate is defined)

Type
integer
Required
Example"202401020000"
DocStatus

A13: Withdrawn (used to return withdrawn documents). By default withdrawn publications are not returned.

Type
string
Example"A13"
mRID

Used to retrieve previous publication versions

Type
string
offset

Integer: Zero‑based index of the first XML document to return. The offset parameter paginates the response in batches of 100 XML documents (e.g., offset = n returns the XMLs 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