The GraphQL API changelog is a list of recent changes to our GraphQL API schema and documentation. It includes bug fixes, backwards-compatible changes or breaking changes on the API as well as updates of this documentation. For a list of breaking changes and when they will occur, see our breaking changes log .

🛠️ Infrastructure updates

• Implemented infrastructure improvements to enhance system stability and performance. These changes affect the IT infrastructure only and do not modify the EAC application functionality.

📘 Documentation

Enhanced documentation in the following sections:

• Added detailed explanations on retrieving service windows for co-optimised baskets.
• Updated auction timing guidelines.

🚀 New features

• Added start and end date fields to unit versions, enhancing version management capabilities.

🐞 Bug fixes

• Added validation check for basket limits when submitting Quick Reserve and Response services together. This fix ensures compliance with existing market rules for the new co-optimisation feature.

New release with minor fixes and enhancements in the UIs. No changes in the APIs.

🚀 New features

• The Quick Reserve (QR) Service Type is now available on the Enduring Auction Capability (EAC) platform, as well as the Positive Quick Reserve (PQR) and Negative Quick Reserve (NQR) Services .
• Quick Reserve will be co-optimised with existing Frequency Response services, including Dynamic Containment (DC), Dynamic Moderation (DM), and Dynamic Regulation (DR).

📘 Documentation

• Updated documentation on creating co-optimised baskets has been added to Baskets .

🔥 Dangerous changes

A new validation rule has been added for the basket family IDs, see dangerous changelog .

📘 Documentation

All URLs and addresses have been updated to align with the new brand identity, resulting from the transition from NGESO to NESO.

• In the section Environments , the links of the EAC Web app, EAC GraphQL API and CIAM openID config have been modified for the different environments (i.e., Production, Sandbox and Mock Auctions).
• The Client IDs and Client Secrets that used by Market Participants up to now are still valid.
• In the section Authentication , the URL to acquire an access token from CIAM has been modified.

🐞 Bug fixes

• Fix an issue where deleting or adding a basket in a unit was not reflecting immediately.
• Resolve performance issues leading to 504 errors with some API endpoints.

🚀 New features

• New field serviceTypes has been added to the auctionSession query to enhance performance.

🐞 Bug fixes

• All prices in the API responses are now rounded to ensure data consistency and accuracy.
• Resolve performance issues leading to 504 Timeout during high volume basket submission mutations.

🚀 New features

• Add filter orderResultStates in the results allowing to filter the service windows results based on the status of the order.

🐞 Bug fixes

• Resolve the performance issue introduced in the previous release, resulting in a long response time and increased CPU usage for the trade API, which was causing a time-out for some market participants when trying to get the sell orders results.

🚀 New features

• New input field serviceWindows in the BasketInput allowing to create at once multiple identical baskets over multiple service windows. It cannot be used at the same time as the field serviceWindow .

📘 Documentation

• Fix queries and mutation examples to fill the service name with the three-letter codes (e.g., DCL for Dynamic Containment Low) instead of the full name.

🚀 New features

• New query sellOrderDataPortalResults available to retrieve auction results in a flatten format similar to the sell order result CSV file from Data Portal .
• New field productID in the SellOrderResult identifying which results belong to the same parent, child or substitutable child order within a basket.
• New field entryTimestamp in the Basket type indicating the creation time of the basket.
• New field duration in the ServiceWindow type indicating the duration in minutes of the service window.

📘 Documentation

• Add more practical information on the production environment .
• Announcement of the decommissioning of the mock auction environment .
• Update the documentation of the Sandbox environment .

Final release before the 16th of October go-live.

🐞 Bug fixes

• Fix regression introduced in the last release, in the enterBaskets mutation, parents without any ServiceVolume should not be allowed.

🚀 New features

• Increase of the length of the basket name and family name from 30 to 250 characters.

📘 Documentation

• Improve the GraphQL reference by adding in the different field's descriptions more information on the validation rules.
• Add a Unit capacity validation section describing the validation rules preventing to enter baskets exceeding your unit capacity.
• Add a Order rejection reason section with a description of the order rejection codes.
• Add a screenshot to show how authenticate with CIAM using Postman.

📘 Documentation

• Information on API authentication with CIAM is now available here
• Information on the Mock Auctions environment is now available here

🐞 Bug fixes

• Fix the sell order results with multiple service windows.
• Fix the validation rule for the max number of child orders and substitutable child orders allowed per basket.
• Fix the validation rule for the total capacity per unit and per direction : substitutable children covering several services are now properly considered.
• New validation rule to ensure that prices are multiple of 0.01 £/MW/h.
• New validation rule to ensure that volumes are integers.

🐞 Bug fixes

• Deletion of baskets is now restricted to auction sessions in status OPEN
• Fix createBaskets mutuation. It is now possible to submit sell orders for the same Unit with different basket values.
• Auction run results now accurately reflect the configuration for paradoxically rejected orders and paradoxically accepted orders.
• Surplus values in the results can now include multiple decimal places.
• Modifications done to ensure that the following validation rules are performed in regards of the volumes of the orders and capacities of the units:
  • The volume submitted in an order for a given service and direction must be smaller than the allocated capacity of the unit for this service and direction
  • Offered quantities are validated at the time of order submission to ensure that the quantities do not imply a violation of the total capacity (sum over all services) of the underlying unit for each direction.
  • Offered quantities are validated at the time of order submission to ensure that the quantities do not imply a violation of the capacity of the underlying unit for each service and direction.
• The serviceWindows query has been fixed and now returns the correct value type.

🚀 New features

• Improve deleteBaskets mutation. A new parameter has been introduced, allowing you to delete a basket by specifying the service window.

🐞 Bug fixes

• Fix auctionSession query. The result does not provide anymore an input validation error in case of a valid query.
• Fix removeBaskets mutation. Specifying the unitIdentifier has the expected behavior.
• Fix retrieval of results with the serviceWindowUnitResults query.
• Baskets that are deleted with the removeBasket and the removeBaskets queries are not used in auctions anymore.
• Child orders providing no services or only services with zero volume are now rejected.

In this new release, we fixed a few issues with the validation of baskets. Because of those missing rules a few invalid baskets were entered by some market participants. This triggered issues with the execution of the auctions the last few days preventing the publication of results. We are monitoring closely the situation to allow proper execution of the auctions.

🚀 New features

• Add two new queries serviceWindow and serviceWindows to retrieve service windows directly.
• The removeBaskets query (replacement of removeAllBaskets ) now gives more control on the baskets you want to delete with optional filters on the unit and the service window.
• The AuctionSession type now have a field auctionStart giving as a timestamp the day and time of the auction.

🔥 Breaking changes

See breaking changelog

🐞 Bug fixes

• Fix baskets validation. A child or substitutable child order must have at least one service with a non-zero volume.
• Fix baskets validation. A basket can not exceed the unit capacity. Refer to the procurement rules for more detail on the exact rule.
• Fix baskets validation. A parent, child or substitutable child order can not have multiple volumes for the same service.
• The removeBaskets query (replacement of removeAllBaskets ) do not anymore give access to baskets of other market participants.

📘 Documentation

• New What's new section in the documentation with the listing of breaking changes and a general change log .
• New Auction sessions section in the documentation with an example on how to retrieve auctions and an explanation of the auction's lifecycle .
• New Auction results section in the documentation with an example on how to retrieve auction results .
• Clarification of the units and format of various fields.
• Update the Postman collection with an example for getting auction results.

🐞 Bug fixes

• Fix the transition of the auction sessions to the PUBLISHED state.

---