openapi: 3.0.1
info:
title: Capacity
description: '
## Introduction
The Capacity API is used by facility operators and trading participants to submit and receive data
relating to capacity trades and day ahead auction for AEMO’s Capacity Transfer Platform (CTP) and
Day-Ahead Auction (DAA) market systems.
For details on how to get access and business rules for this API:
'
version: v1
x-origin:
- format: openapi
version: '3.0'
source: AEMO API Management developer portal
url: https://dev.aemo.com.au/developer/apis/capacity-v1/operations?api-version=2022-04-01-preview
servers:
- url: https://api-prd.aemo.local/ws/gsh/capacity
paths:
/reportTransportationServicePointRegister:
get:
operationId: getAListOfAllTheServicePointsZonesAndPipelineSegments
summary: Get a list of all the service points, zones and pipeline segments
tags:
- Capacity
description: The report contains list of all the service points (receipt and delivery points), zones
and pipeline segments currently registered under Part 24 of the Rules, for the capacity transfer
and day ahead auction.
parameters:
- name: ComponentType
in: query
required: false
schema:
type: string
enum:
- ZONE
- SEGMENT
- SERVICE_POINT
- NOTIONAL_POINT
- PARK_SERVICE
description: Type of component
- name: X-initiatingParticipantID
in: header
required: true
schema:
type: string
description: The ID of the Initiating Participant
- name: X-market
in: header
required: false
schema:
type: string
description: The market type that the request applies.
- name: Authorization
in: header
required: true
schema:
type: string
responses:
'200':
description: Successful reponse with the Transportation facilities report
content:
application/json:
example:
transactionId: 27d225a6-6c9a-4081-81dc-eb643fdd2a6e
data:
Zones:
- ZoneId: 20001
ZoneName: Zone 1
ZoneType: Pipeline Receipt
ZoneDescription: Some sort of description
ForAuctionPublication: 'Yes'
EffectiveDate: '2018-02-28T02:00:00Z'
VersionDatetime: '2018-02-01T02:23:45Z'
LastChanged: '2018-05-01T02:23:45Z'
- ZoneId: 20002
ZoneName: Zone 2
ZoneType: Pipeline Delivery
ZoneDescription: Some sort of description
ForAuctionPublication: 'Yes'
EffectiveDate: '2018-02-28T02:00:00Z'
VersionDatetime: '2018-02-01T02:23:45Z'
LastChanged: '2018-05-01T02:23:45Z'
Segments:
- FacilityId: 100001
FacilityName: Moomba to Adelaide Pipeline System
SegmentId: 30001
SegmentName: Segment 1
SegmentType: Forward Haul
FromId: 20001
FromName: Zone 1
ToId: 30001
ToName: Zone 2
ForAuctionPublication: 'Yes'
EffectiveDate: '2018-02-28T02:00:00Z'
VersionDatetime: '2018-02-01T02:23:45Z'
LastChanged: '2018-05-01T02:23:45Z'
- FacilityId: 100001
FacilityName: Moomba to Adelaide Pipeline System
SegmentId: 30001
SegmentName: Segment 1
SegmentType: Forward Haul
FromId: 20002
FromName: Zone 22
ToId: 30002
ToName: Zone 33
ForAuctionPublication: 'Yes'
EffectiveDate: '2018-02-28T02:00:00Z'
VersionDatetime: '2018-02-01T02:23:45Z'
LastChanged: '2018-05-01T02:23:45Z'
ServicePoints:
- FacilityId: 100001
FacilityName: Moomba to Adelaide Pipeline System
ServicePointId: 50001
ServicePointName: SP 1
ServicePointType: Forward Haul Receipt Point
ServicePointDescription: Some description
NotionalPoint: 'Yes'
ZoneId: 20002
ZoneName: Zone 2
GBBConnectionPointId: 150001
GBBConnectionPointName: Moomba Gas Plant
ForAuctionPublication: 'Yes'
EffectiveDate: '2018-02-28T02:00:00Z'
VersionDatetime: '2018-02-01T02:23:45Z'
LastChanged: '2018-05-01T02:23:45Z'
- FacilityId: 100001
FacilityName: Moomba to Adelaide Pipeline System
ServicePointId: 50001
ServicePointName: SP 1
ServicePointType: Forward Haul Receipt Point
ServicePointDescription: Some description
NotionalPoint: 'Yes'
ZoneId: 20002
ZoneName: Zone 2
GBBConnectionPointId: 150001
GBBConnectionPointName: Moomba Gas Plant
ForAuctionPublication: 'Yes'
EffectiveDate: '2018-02-28T02:00:00Z'
VersionDatetime: '2018-02-01T02:23:45Z'
LastChanged: '2018-05-01T02:23:45Z'
NotionalPoints:
- ServicePointId: 500001
ServicePointName: SP 1
PhysicalPointName: SP 2
GBBConnectionPointId: '150001'
EffectiveDate: '2018-02-28T02:00:00Z'
VersionDatetime: '2018-02-01T02:23:45Z'
LastChanged: '2018-05-01T02:23:45Z'
- ServicePointId: 500001
ServicePointName: SP 1
PhysicalPointName: SP 3
GBBConnectionPointId: '150002'
EffectiveDate: '2018-02-28T02:00:00Z'
VersionDatetime: '2018-02-01T02:23:45Z'
LastChanged: '2018-05-01T02:23:45Z'
ParkServices:
- ParkProductName: Park Service 1
ParkServicePointId: 500001
ParkServicePointName: SP 1
EffectiveDate: '2018-02-28T02:00:00Z'
VersionDatetime: '2018-02-01T02:23:45Z'
LastChanged: '2018-05-01T02:23:45Z'
- ParkProductName: Park Service 23
ParkServicePointId: 500022
ParkServicePointName: SP 22
EffectiveDate: '2018-02-28T02:00:00Z'
VersionDatetime: '2018-02-01T02:23:45Z'
LastChanged: '2018-05-01T02:23:45Z'
errors: []
'400':
description: The service cannot be found for the endpoint reference (EPR)
content:
application/json:
example:
Fault:
'401':
description: This response is provided when "Authorisation" is missing from the header OR user/password
is incorrect/not provided OR user account is locked out.
content:
application/json:
example:
Exception: Unauthorized:Invalid UserName or Password
'403':
description: This response is provided when there is an invalid Role i.e. user does not have
permission to submit this request.
'404':
description: This response is provided when the resource is missing from the URL or the URL
is incorrect.
content:
application/json:
example:
Exception: 'Resources for the endpoint URI not found. Endpoint URI: '
'405':
description: Invalid Method used (e.g. GET used instead of POST)
content:
application/json:
example:
Exception: 'Input request HTTP method is but operation accepts only: []'
'411':
description: This response is provided when "Content-Length" is missing from the Header
'422':
description: This response is provided when any there are any Business validation failures,
then entire submission is rejected.
'500':
description: e-Hub is operational but downstream systems are not available.
content:
application/json:
example:
Exception: Application Unavailable
'503':
description: Exceeds throttling limits OR SSL Certificate authentication validation failed
content:
application/json:
example:
Exception: 'Service invocation for API was rejected based on policy violation OR Error
message: javax.net.ssl.SSLHandshakeException: Received fatal alert: bad_certificate'
/reportRegisteredParticipants:
get:
operationId: getAllParticipantsCurrentlyRegisteredInTheGSHCTPAndDAAMarkets
summary: Get all participants currently registered in the GSH, CTP and DAA markets.
tags:
- Capacity
description: The report contains the registration details of all participants currently registered
in the GSH, CTP and DAA markets.
parameters:
- name: Markets
in: query
required: true
schema:
type: string
- name: X-initiatingParticipantID
in: header
required: true
schema:
type: string
description: The ID of the Initiating Participant
- name: X-market
in: header
required: false
schema:
type: string
description: The market type that the request applies.
- name: Authorization
in: header
required: true
schema:
type: string
responses:
'200':
description: Successful reponse with registered participants report
content:
application/json:
example:
transactionId: 27d225a6-6c9a-4081-81dc-eb643fdd2a3d
data:
Participants:
- Market: Gas Supply Hub
ParticipantId: '74'
ParticipantCode: ES584
OrganisationName: AGL
OrganisationCode: AG256
TradingName: AGL Hydro Partnership
HeadOfficeAddressLine1: 50 Collins St
HeadOfficeAddressLine2: Melbourne
HeadOfficeAddressLine3: VIC
HeadOfficeAddressLine4: '3001'
PhoneNumber: 03 9658 7000
FaxNumber: 03 9658 7589
ABN: '456874258'
ARBN: '125874569'
ACN: '569845214'
Classifications: Facility Operator
AgentId: 123
AgentName: Star Energy Pty Ltd
LastChanged: '2018-05-01T02:23:45Z'
- Market: Gas Supply Hub
ParticipantId: '56'
ParticipantCode: ORRE
OrganisationName: Origin Energy Retail Ltd
OrganisationCode: ORIGINRETAIL
TradingName: Origin Energy Retail Ltd
HeadOfficeAddressLine1: Level 45
HeadOfficeAddressLine2: 264-278 George Street
HeadOfficeAddressLine3: Sydney
HeadOfficeAddressLine4: NSW 2000
PhoneNumber: 0295035209
FaxNumber: 0292524066
ABN: '22078868425'
ARBN: ''
ACN: '78868425'
Classifications: Trader
AgentId: 123
AgentName: Star Energy Pty Ltd
LastChanged: '2018-05-01T02:23:45Z'
errors: []
'400':
description: The service cannot be found for the endpoint reference (EPR)
content:
application/json:
example:
Fault:
'401':
description: This response is provided when "Authorisation" is missing from the header OR user/password
is incorrect/not provided OR user account is locked out.
content:
application/json:
example:
Exception: Unauthorized:Invalid UserName or Password
'403':
description: This response is provided when there is an invalid Role i.e. user does not have
permission to submit this request.
'404':
description: This response is provided when the resource is missing from the URL or the URL
is incorrect.
content:
application/json:
example:
Exception: 'Resources for the endpoint URI not found. Endpoint URI: '
'405':
description: Invalid Method used (e.g. GET used instead of POST)
content:
application/json:
example:
Exception: 'Input request HTTP method is but operation accepts only: []'
'411':
description: This response is provided when "Content-Length" is missing from the Header
'422':
description: This response is provided when any there are any Business validation failures,
then entire submission is rejected.
'500':
description: e-Hub is operational but downstream systems are not available.
content:
application/json:
example:
Exception: Application Unavailable
'503':
description: Exceeds throttling limits OR SSL Certificate authentication validation failed
content:
application/json:
example:
Exception: 'Service invocation for API was rejected based on policy violation OR Error
message: javax.net.ssl.SSLHandshakeException: Received fatal alert: bad_certificate'
/contractDetails:
post:
operationId: provideAListOfValidShipperContractsForAFacility
summary: Provide a list of valid shipper contracts for a facility.
tags:
- Capacity
description: 'Each submission must contain the full set of shipper contracts that are valid beyond
the submission date in accordance with the Procedures.
On submission of this data, the system replaces all contract details previously submitted by the
facility operator with the contents of the new submission.
This information is used by shippers to select an appropriate contract for a capacity product
prior to trading.
STTM contract references must be firm i.e. must be a Priority 1 registered facility service.'
parameters:
- name: X-initiatingParticipantID
in: header
required: true
schema:
type: string
description: The ID of the Initiating Participant
- name: X-market
in: header
required: false
schema:
type: string
description: The market type that the request applies.
- name: Authorization
in: header
required: true
schema:
type: string
requestBody:
content:
application/json:
example:
ItemList:
FacilityId: 530001
ParticipantId: '13'
ServiceReference: SR00000001
ServiceReferenceDescription: ID for service in easterly direction
STTMContractReference: RS0000011
ContractType: TRADE
StartDate: '2018-05-01T12:00:00Z'
EndDate: '2018-05-01T12:00:00Z'
responses:
'200':
description: Successful
'400':
description: The service cannot be found for the endpoint reference (EPR)
content:
application/json:
example:
Fault:
'401':
description: This response is provided when "Authorisation" is missing from the header OR user/password
is incorrect/not provided OR user account is locked out.
content:
application/json:
example:
Exception: Unauthorized:Invalid UserName or Password
'403':
description: This response is provided when there is an invalid Role i.e. user does not have
permission to submit this request.
'404':
description: This response is provided when the resource is missing from the URL or the URL
is incorrect.
content:
application/json:
example:
Exception: 'Resources for the endpoint URI not found. Endpoint URI: '
'405':
description: Invalid Method used (e.g. GET used instead of POST)
content:
application/json:
example:
Exception: 'Input request HTTP method is but operation accepts only: []'
'411':
description: This response is provided when "Content-Length" is missing from the Header
'422':
description: This response is provided when any there are any Business validation failures,
then entire submission is rejected.
'500':
description: e-Hub is operational but downstream systems are not available.
content:
application/json:
example:
Exception: Application Unavailable
'503':
description: Exceeds throttling limits OR SSL Certificate authentication validation failed
content:
application/json:
example:
Exception: 'Service invocation for API was rejected based on policy violation OR Error
message: javax.net.ssl.SSLHandshakeException: Received fatal alert: bad_certificate'
/capacityTransferStatus:
post:
operationId: provideAStatusOfCapacityTransferForEachCapacityTransferNotice
summary: Provide a status of capacity transfer for each capacity transfer notice.
tags:
- Capacity
description: 'Provide a status of capacity transfer for each capacity transfer notice.
Partial submissions are accepted. This allows facility operators to submit interim PENDING statuses
for transfers that have failed.
Facility operators are responsible for pro-rating capacity quantities where applicable i.e. if
there is a shipper capacity shortfall.
Facility operators may continue to submit this transaction beyond the cut-off time for the purposes
of updating the invalid quantity and reason.
Changes to day ahead capacity transfer transaction status and confirmed capacity quantity will
be ignored after the day ahead transfer cut-off time.
Changes to D-2 and ‘bundled products’ forward traded capacity transfer transaction status and
confirmed capacity quantity will be ignored after the forward traded capacity transfer cut-off
time.
Changes to D-3 (and beyond) forward traded capacity transaction status and confirmed capacity
quantity will be accepted for up to 24 hours after the forward traded capacity transfer cut-off
time.'
parameters:
- name: X-initiatingParticipantID
in: header
required: true
schema:
type: string
description: The ID of the Initiating Participant
- name: X-market
in: header
required: false
schema:
type: string
description: The market type that the request applies.
- name: Authorization
in: header
required: true
schema:
type: string
requestBody:
content:
application/json:
example:
ItemList:
CapacityTransferId: 10001
TransactionStatus: TRANSFERRED
ConfirmedCapacityQuantity: 96
Reason: PIPELINE_CONSTRAINED
InvalidQuantity: 30
responses:
'200':
description: Successful
'400':
description: The service cannot be found for the endpoint reference (EPR)
content:
application/json:
example:
Fault:
'401':
description: This response is provided when "Authorisation" is missing from the header OR user/password
is incorrect/not provided OR user account is locked out.
content:
application/json:
example:
Exception: Unauthorized:Invalid UserName or Password
'403':
description: This response is provided when there is an invalid Role i.e. user does not have
permission to submit this request.
'404':
description: This response is provided when the resource is missing from the URL or the URL
is incorrect.
content:
application/json:
example:
Exception: 'Resources for the endpoint URI not found. Endpoint URI: '
'405':
description: Invalid Method used (e.g. GET used instead of POST)
content:
application/json:
example:
Exception: 'Input request HTTP method is but operation accepts only: []'
'411':
description: This response is provided when "Content-Length" is missing from the Header
'422':
description: This response is provided when any there are any Business validation failures,
then entire submission is rejected.
'500':
description: e-Hub is operational but downstream systems are not available.
content:
application/json:
example:
Exception: Application Unavailable
'503':
description: Exceeds throttling limits OR SSL Certificate authentication validation failed
content:
application/json:
example:
Exception: 'Service invocation for API was rejected based on policy violation OR Error
message: javax.net.ssl.SSLHandshakeException: Received fatal alert: bad_certificate'
/auctionServiceCurtailmentNotice:
post:
operationId: provideAEMOWithNoticeOfAnAuctionServiceCurtailmentOnAnAuctionFacilityDuringAGasDay
summary: Provide AEMO with notice of an auction service curtailment on an auction facility during
a gas day.
tags:
- Capacity
description: Provide AEMO with notice of an auction service curtailment on an auction facility during
a gas day.
parameters:
- name: X-initiatingParticipantID
in: header
required: true
schema:
type: string
description: The ID of the Initiating Participant
- name: X-market
in: header
required: false
schema:
type: string
description: The market type that the request applies.
- name: Authorization
in: header
required: true
schema:
type: string
requestBody:
content:
application/json:
example:
ItemList:
FacilityId: 530001
AuctionService: FORWARD_HAUL
Curtailed: 'true'
Material: 'true'
Description: Why the curtailment has occurred
EffectiveDateTime: '2018-05-01T12:00:00Z'
GasDate: '2018-05-01T12:00:00Z'
responses:
'200':
description: Successful
'400':
description: The service cannot be found for the endpoint reference (EPR)
content:
application/json:
example:
Fault:
'401':
description: This response is provided when "Authorisation" is missing from the header OR user/password
is incorrect/not provided OR user account is locked out.
content:
application/json:
example:
Exception: Unauthorized:Invalid UserName or Password
'403':
description: This response is provided when there is an invalid Role i.e. user does not have
permission to submit this request.
'404':
description: This response is provided when the resource is missing from the URL or the URL
is incorrect.
content:
application/json:
example:
Exception: 'Resources for the endpoint URI not found. Endpoint URI: '
'405':
description: Invalid Method used (e.g. GET used instead of POST)
content:
application/json:
example:
Exception: 'Input request HTTP method is but operation accepts only: []'
'411':
description: This response is provided when "Content-Length" is missing from the Header
'422':
description: This response is provided when any there are any Business validation failures,
then entire submission is rejected.
'500':
description: e-Hub is operational but downstream systems are not available.
content:
application/json:
example:
Exception: Application Unavailable
'503':
description: Exceeds throttling limits OR SSL Certificate authentication validation failed
content:
application/json:
example:
Exception: 'Service invocation for API was rejected based on policy violation OR Error
message: javax.net.ssl.SSLHandshakeException: Received fatal alert: bad_certificate'
/zoneCurtailmentInformation:
post:
operationId: provideAEMOWithNoticeOfCurtailedShipperNominationsAgainstSecondaryFirmRights
summary: Provide AEMO with notice of curtailed shipper nominations against secondary firm rights.
tags:
- Capacity
description: Provide AEMO with notice of curtailed shipper nominations against secondary firm rights.
parameters:
- name: X-initiatingParticipantID
in: header
required: true
schema:
type: string
description: The ID of the Initiating Participant
- name: X-market
in: header
required: false
schema:
type: string
description: The market type that the request applies.
- name: Authorization
in: header
required: true
schema:
type: string
requestBody:
content:
application/json:
example:
ItemList:
FacilityId: 530001
ServicePointId: 3001
GasDate: '2018-05-01T12:00:00Z'
CurtailedQuantity: 455
responses:
'200':
description: Successful
'400':
description: The service cannot be found for the endpoint reference (EPR)
content:
application/json:
example:
Fault:
'401':
description: This response is provided when "Authorisation" is missing from the header OR user/password
is incorrect/not provided OR user account is locked out.
content:
application/json:
example:
Exception: Unauthorized:Invalid UserName or Password
'403':
description: This response is provided when there is an invalid Role i.e. user does not have
permission to submit this request.
'404':
description: This response is provided when the resource is missing from the URL or the URL
is incorrect.
content:
application/json:
example:
Exception: 'Resources for the endpoint URI not found. Endpoint URI: '
'405':
description: Invalid Method used (e.g. GET used instead of POST)
content:
application/json:
example:
Exception: 'Input request HTTP method is but operation accepts only: []'
'411':
description: This response is provided when "Content-Length" is missing from the Header
'422':
description: This response is provided when any there are any Business validation failures,
then entire submission is rejected.
'500':
description: e-Hub is operational but downstream systems are not available.
content:
application/json:
example:
Exception: Application Unavailable
'503':
description: Exceeds throttling limits OR SSL Certificate authentication validation failed
content:
application/json:
example:
Exception: 'Service invocation for API was rejected based on policy violation OR Error
message: javax.net.ssl.SSLHandshakeException: Received fatal alert: bad_certificate'
/reportShipperCapacityTransferNotification:
get:
operationId: provideConfirmationToFacilityOperatorThatShipperIsNotifiedOfACapacityTransferOutcome
summary: Provide confirmation to facility operator that shipper is notified of a capacity transfer
outcome.
tags:
- Capacity
description: 'Provide confirmation to facility operator that shipper is notified of a capacity transfer
outcome.
Failed capacity transfer can be due to-
- Facility operator system failure preventing the capacity transfer in their system.
- Facility operator system rejects the capacity transfer due to an issue with the contract specified.
- AEMO system failure preventing the capacity transfer in the STTM or DWGM system.
- AEMO STTM or DWGM system rejects the capacity transfer due to an issue with the STTM registered
facility service (CRN) or DWGM accreditation reference specified.
Park product transfers are identified by empty zone details and identical receipt and delivery
points.'
parameters:
- name: FromGasDate
in: query
required: false
schema:
type: string
description: One calendar month from request date
- name: ToGasDate
in: query
required: false
schema:
type: string
description: Request date
- name: ChangedAfter
in: query
required: false
schema:
type: string
description: Changed After Date
- name: X-initiatingParticipantID
in: header
required: true
schema:
type: string
description: The ID of the Initiating Participant
- name: X-market
in: header
required: false
schema:
type: string
description: The market type that the request applies.
- name: Authorization
in: header
required: true
schema:
type: string
responses:
'200':
description: Successful reponse Shipper Capacity Transfer report
content:
application/json:
example:
transactionId: 27d225a6-6c9a-4081-81dc-eb643fdd2a2d
data:
CapacityTransfers:
- CapacityTransferId: 10001
GasDate: '2018-05-01T02:00:00Z'
ParticipantId: '13'
ParticipantCode: SE584
ParticipantName: Star Energy
FacilityId: 530001
FacilityName: VIC Pipeline
ServiceReference: SR00000001
STTMContractReference: RS00011
DWGMAccreditationReference: ''
ReceiptPointId: 1001
ReceiptPointName: Echuca
DeliveryPointId: 2001
DeliveryPointName: Melbourne
ReceiptZoneId: 3001
ReceiptZoneName: Echuca Zone
DeliveryZoneId: 4001
DeliveryZoneName: Melbourne Zone
Status: TRANSFERRED
System: SERVICE_PROVIDER
Reason: ''
TransactionCompletedFlag: 'Yes'
OverallQuantityChange: -345
LastChanged: '2018-05-01T02:23:45Z'
- CapacityTransferId: 10002
GasDate: '2018-05-01T02:00:00Z'
ParticipantId: '13'
ParticipantCode: SE584
ParticipantName: Star Energy
FacilityId: 530001
FacilityName: VIC Pipeline
ServiceReference: SR00000002
STTMContractReference: RS00022
DWGMAccreditationReference: MIRN002
ReceiptPointId: 1001
ReceiptPointName: Echuca
DeliveryPointId: 2001
DeliveryPointName: Melbourne
ReceiptZoneId: 3001
ReceiptZoneName: Echuca Zone
DeliveryZoneId: 4001
DeliveryZoneName: Melbourne Zone
Status: PENDING
System: SERVICE_PROVIDER
Reason: BUYER_INVALID_CONTRACT
TransactionCompletedFlag: 'Yes'
OverallQuantityChange: -345
LastChanged: '2018-05-01T02:23:45Z'
errors: ''
'400':
description: The service cannot be found for the endpoint reference (EPR)
content:
application/json:
example:
Fault:
'401':
description: This response is provided when "Authorisation" is missing from the header OR user/password
is incorrect/not provided OR user account is locked out.
content:
application/json:
example:
Exception: Unauthorized:Invalid UserName or Password
'403':
description: This response is provided when there is an invalid Role i.e. user does not have
permission to submit this request.
'404':
description: This response is provided when the resource is missing from the URL or the URL
is incorrect.
content:
application/json:
example:
Exception: 'Resources for the endpoint URI not found. Endpoint URI: '
'405':
description: Invalid Method used (e.g. GET used instead of POST)
content:
application/json:
example:
Exception: 'Input request HTTP method is but operation accepts only: []'
'411':
description: This response is provided when "Content-Length" is missing from the Header
'422':
description: This response is provided when any there are any Business validation failures,
then entire submission is rejected.
'500':
description: e-Hub is operational but downstream systems are not available.
content:
application/json:
example:
Exception: Application Unavailable
'503':
description: Exceeds throttling limits OR SSL Certificate authentication validation failed
content:
application/json:
example:
Exception: 'Service invocation for API was rejected based on policy violation OR Error
message: javax.net.ssl.SSLHandshakeException: Received fatal alert: bad_certificate'
/auctionSettlementQuantities:
post:
operationId: provideTheActualAuctionQuantitiesAndFinalNominationsAfterTheEndOfEachGasDay
summary: Provide the actual auction quantities and final nominations after the end of each gas day.
tags:
- Capacity
description: 'Provide the actual auction quantities and final nominations after the end of each
gas day.
This information is required by AEMO for settlement purposes.
If multiple submissions are received by AEMO, the data received in the latest submission prior
to the cut-off time is used for indicative or final settlements.
Auction quantity is used for settlements if data is not received by the cut-off time'
parameters:
- name: X-initiatingParticipantID
in: header
required: true
schema:
type: string
description: The ID of the Initiating Participant
- name: X-market
in: header
required: false
schema:
type: string
description: The market type that the request applies.
- name: Authorization
in: header
required: true
schema:
type: string
requestBody:
content:
application/json:
example:
ItemList:
AuctionTransactionId: 10001
RevisedAuctionQuantity: 100
Reason: PIPELINE_CONSTRAINED
FinalScheduledQuantity: 100
responses:
'200':
description: Successful reponse with Facilites report
'400':
description: The service cannot be found for the endpoint reference (EPR)
content:
application/json:
example:
Fault:
'401':
description: This response is provided when "Authorisation" is missing from the header OR user/password
is incorrect/not provided OR user account is locked out.
content:
application/json:
example:
Exception: Unauthorized:Invalid UserName or Password
'403':
description: This response is provided when there is an invalid Role i.e. user does not have
permission to submit this request.
'404':
description: This response is provided when the resource is missing from the URL or the URL
is incorrect.
content:
application/json:
example:
Exception: 'Resources for the endpoint URI not found. Endpoint URI: '
'405':
description: Invalid Method used (e.g. GET used instead of POST)
content:
application/json:
example:
Exception: 'Input request HTTP method is but operation accepts only: []'
'411':
description: This response is provided when "Content-Length" is missing from the Header
'422':
description: This response is provided when any there are any Business validation failures,
then entire submission is rejected.
'500':
description: e-Hub is operational but downstream systems are not available.
content:
application/json:
example:
Exception: Application Unavailable
'503':
description: Exceeds throttling limits OR SSL Certificate authentication validation failed
content:
application/json:
example:
Exception: 'Service invocation for API was rejected based on policy violation OR Error
message: javax.net.ssl.SSLHandshakeException: Received fatal alert: bad_certificate'
/auctionQuantities:
post:
operationId: provideTheAuctionQuantitiesAvailableForTheDayAheadAuction
summary: Provide the auction quantities available for the day ahead auction.
tags:
- Capacity
description: Provide the auction quantities available for the day ahead auction. A submission may
include one or more facilities. A full set of product components must be provided for each facility
included in a submission. For example, if two facilities are included in one submission, one facility
has a full set of limits specified and the other does not, the entire submission will be rejected.
If multiple submissions are received by AEMO, the data received in the latest submission for each
facility prior to the cut-off time is used as input into the auction.
parameters:
- name: X-initiatingParticipantID
in: header
required: true
schema:
type: string
description: The ID of the Initiating Participant
- name: X-market
in: header
required: false
schema:
type: string
description: The market type that the request applies.
- name: Authorization
in: header
required: true
schema:
type: string
requestBody:
content:
application/json:
example:
ItemList:
AuctionDate: '2018-05-01T12:00:00Z'
GasDate: '2018-05-01T12:00:00Z'
FacilityId: 530001
LimitId: 3001
LimitQuantity: 230
TransitionalRightsQuantity: 120
OperationalOverride: 'true'
responses:
'200':
description: Successful
'400':
description: The service cannot be found for the endpoint reference (EPR)
content:
application/json:
example:
Fault:
'401':
description: This response is provided when "Authorisation" is missing from the header OR user/password
is incorrect/not provided OR user account is locked out.
content:
application/json:
example:
Exception: Unauthorized:Invalid UserName or Password
'403':
description: This response is provided when there is an invalid Role i.e. user does not have
permission to submit this request.
'404':
description: This response is provided when the resource is missing from the URL or the URL
is incorrect.
content:
application/json:
example:
Exception: 'Resources for the endpoint URI not found. Endpoint URI: '
'405':
description: Invalid Method used (e.g. GET used instead of POST)
content:
application/json:
example:
Exception: 'Input request HTTP method is but operation accepts only: []'
'411':
description: This response is provided when "Content-Length" is missing from the Header
'422':
description: This response is provided when any there are any Business validation failures,
then entire submission is rejected.
'500':
description: e-Hub is operational but downstream systems are not available.
content:
application/json:
example:
Exception: Application Unavailable
'503':
description: Exceeds throttling limits OR SSL Certificate authentication validation failed
content:
application/json:
example:
Exception: 'Service invocation for API was rejected based on policy violation OR Error
message: javax.net.ssl.SSLHandshakeException: Received fatal alert: bad_certificate'
/reportAuctionResults:
get:
operationId: provideTheCapacityQuantityWonByShippersAtAuction
summary: Provide the capacity quantity won by shippers at auction.
tags:
- Capacity
description: 'Provide the capacity quantity won by shippers at auction.
Facility operators use this data to assign capacity of auction services to shippers.
Facility operators that have an active facility in the auction will receive this report, regardless
of whether there is any auction quantity won on their facility.
Auction participants that have an active bid in the auction will receive this report, regardless
of whether they win any capacity in the auction.'
parameters:
- name: FacilityId
in: query
required: false
schema:
type: integer
description: The unique AEMO defined Facility identifier.
- name: FromAuctionDate
in: query
required: false
schema:
type: string
description: From Auction Date
- name: ToAuctionDate
in: query
required: false
schema:
type: string
description: To Auction Date
- name: FromGasDate
in: query
required: false
schema:
type: string
description: One calendar month from request date
- name: ToGasDate
in: query
required: false
schema:
type: string
description: Request date
- name: X-initiatingParticipantID
in: header
required: true
schema:
type: string
description: The ID of the Initiating Participant
- name: X-market
in: header
required: false
schema:
type: string
description: The market type that the request applies.
- name: Authorization
in: header
required: true
schema:
type: string
responses:
'200':
description: Successful reponse with report on capacity quantity won at auction
content:
application/json:
example:
transactionId: 27d225a6-6c9a-4081-81dc-eb643fdd2a7d
data:
AuctionRun:
- AuctionDate: '2018-05-01T02:23:45Z'
GasDate: '2018-05-02T02:23:45Z'
AuctionRunDatetime: '2018-05-01T02:23:45Z'
ParticipantId: '584'
ParticipantCode: STAR
LastChanged: '2018-05-01T12:23:45Z'
AuctionResults:
- AuctionTransactionId: 10001
AuctionDate: '2018-04-30T02:00:00Z'
FacilityId: 530001
FacilityName: VIC Pipeline
ParticipantId: '13'
ParticipantCode: STAR
ParticipantName: Star Energy
ServiceReference: SR00000001
ReceiptPointId: 1001
ReceiptPointName: Echuca
RPDWGMReference: 23 200001PC
DeliveryPointId: 2001
DeliveryPointName: Melbourne
DPDWGMReference: ''
AuctionQuantityWon: 100
GasDate: '2018-05-01T02:00:00Z'
ProductPrice: 3.15
LastChanged: '2018-05-01T02:23:45Z'
- AuctionTransactionId: 10002
AuctionDate: '2018-04-30T02:00:00Z'
FacilityId: 530001
FacilityName: VIC Pipeline
ParticipantId: '13'
ParticipantCode: STAR
ParticipantName: Star Energy
ServiceReference: SR00000002
ReceiptPointId: 1002
ReceiptPointName: Mildura
RPDWGMReference: 23 200001PC
DeliveryPointId: 2002
DeliveryPointName: Echuca
DPDWGMReference: ''
AuctionQuantityWon: 45
GasDate: '2018-05-01T02:00:00Z'
ProductPrice: 5.22
LastChanged: '2018-05-01T02:23:45Z'
errors: ''
'400':
description: The service cannot be found for the endpoint reference (EPR)
content:
application/json:
example:
Fault:
'401':
description: This response is provided when "Authorisation" is missing from the header OR user/password
is incorrect/not provided OR user account is locked out.
content:
application/json:
example:
Exception: Unauthorized:Invalid UserName or Password
'403':
description: This response is provided when there is an invalid Role i.e. user does not have
permission to submit this request.
'404':
description: This response is provided when the resource is missing from the URL or the URL
is incorrect.
content:
application/json:
example:
Exception: 'Resources for the endpoint URI not found. Endpoint URI: '
'405':
description: Invalid Method used (e.g. GET used instead of POST)
content:
application/json:
example:
Exception: 'Input request HTTP method is but operation accepts only: []'
'411':
description: This response is provided when "Content-Length" is missing from the Header
'422':
description: This response is provided when any there are any Business validation failures,
then entire submission is rejected.
'500':
description: e-Hub is operational but downstream systems are not available.
content:
application/json:
example:
Exception: Application Unavailable
'503':
description: Exceeds throttling limits OR SSL Certificate authentication validation failed
content:
application/json:
example:
Exception: 'Service invocation for API was rejected based on policy violation OR Error
message: javax.net.ssl.SSLHandshakeException: Received fatal alert: bad_certificate'
/reportCapacityTransferNotice:
get:
operationId: providesTheCapacityQuantityAdjustmentRequiredForAShipperContract
summary: Provides the capacity quantity adjustment required for a shipper contract.
tags:
- Capacity
description: 'Provide the capacity quantity adjustment required for a shipper contract.
Facility operators use this data to update the capacity quantity on the relevant shipper contracts
in their own systems.
Each published version of the data contains both the incremental adjustment quantity and the cumulative/overall
adjustment quantity that must be applied to a shipper’s contracted capacity quantity, on the same
day that this report is published.
Park product transfers are identified by empty zone details and identical receipt and delivery
points.'
parameters:
- name: FacilityId
in: query
required: false
schema:
type: integer
description: The unique AEMO defined Facility identifier.
- name: ChangedAfter
in: query
required: false
schema:
type: string
description: Changed After Date
- name: FromGasDate
in: query
required: false
schema:
type: string
description: One calendar month from request date
- name: ToGasDate
in: query
required: false
schema:
type: string
description: Request date
- name: X-initiatingParticipantID
in: header
required: true
schema:
type: string
description: The ID of the Initiating Participant
- name: X-market
in: header
required: false
schema:
type: string
description: The market type that the request applies.
- name: Authorization
in: header
required: true
schema:
type: string
responses:
'200':
description: Successful reponse with report on capacity transfer notice
content:
application/json:
example:
transactionId: 27d225a6-6c9a-4081-81dc-eb643fdd2a1d
data:
CapacityTransfers:
- CapacityTransferId: 10001
CapacityTransferGroupId: 201
FacilityId: 530001
FacilityName: VIC Pipeline
ParticipantId: '13'
ParticipantName: Star Energy
ServiceReference: SR00000001
STTMContractReference: RS0001
ReceiptPointId: 1001
ReceiptPointName: Echuca
DeliveryPointId: 2001
DeliveryPointName: Melbourne
ReceiptZoneId: 3001
ReceiptZoneName: Echuca Zone
DeliveryZoneId: 4001
DeliveryZoneName: Melbourne Zone
GasDate: '2018-05-19T02:00:00Z'
IncrementalQuantityChange: 100
OverallQuantityChange: 100
LastChanged: '2018-05-01T02:23:45Z'
- CapacityTransferId: 10002
CapacityTransferGroupId: 201
FacilityId: 530001
FacilityName: VIC Pipeline
ParticipantId: '13'
ParticipantName: Star Energy
ServiceReference: SR00000002
STTMContractReference: RS0002
ReceiptPointId: 1002
ReceiptPointName: Mildura
DeliveryPointIdDeliveryPointID: 2002
DeliveryPointName: Echuca
ReceiptZoneId: 3002
ReceiptZoneName: Mildura Zone
DeliveryZoneId: 4002
DeliveryZoneName: Echuca Zone
GasDate: '2018-05-24T02:00:00Z'
IncrementalQuantityChange: -200
OverallQuantityChange: 0
LastChanged: '2018-05-01T02:23:45Z'
errors: ''
'400':
description: The service cannot be found for the endpoint reference (EPR)
content:
application/json:
example:
Fault:
'401':
description: This response is provided when "Authorisation" is missing from the header OR user/password
is incorrect/not provided OR user account is locked out.
content:
application/json:
example:
Exception: Unauthorized:Invalid UserName or Password
'403':
description: This response is provided when there is an invalid Role i.e. user does not have
permission to submit this request.
'404':
description: This response is provided when the resource is missing from the URL or the URL
is incorrect.
content:
application/json:
example:
Exception: 'Resources for the endpoint URI not found. Endpoint URI: '
'405':
description: Invalid Method used (e.g. GET used instead of POST)
content:
application/json:
example:
Exception: 'Input request HTTP method is but operation accepts only: []'
'411':
description: This response is provided when "Content-Length" is missing from the Header
'422':
description: This response is provided when any there are any Business validation failures,
then entire submission is rejected.
'500':
description: e-Hub is operational but downstream systems are not available.
content:
application/json:
example:
Exception: Application Unavailable
'503':
description: Exceeds throttling limits OR SSL Certificate authentication validation failed
content:
application/json:
example:
Exception: 'Service invocation for API was rejected based on policy violation OR Error
message: javax.net.ssl.SSLHandshakeException: Received fatal alert: bad_certificate'
/reportTransportationFacilityRegister:
get:
operationId: theReportContainsAListOfAllTheFacilities
summary: The report contains a list of all the facilities
tags:
- Capacity
description: The report contains a list of all the facilities currently registered under Part 24
of the Rules, for the capacity transfer and day ahead auction.
parameters:
- name: OperatorIds
in: query
required: false
schema:
type: integer
description: The unique identifier of the Facility Operator that operates the facility.
- name: FacilityId
in: query
required: false
schema:
type: integer
description: The unique AEMO defined Facility identifier.
- name: X-initiatingParticipantID
in: header
required: true
schema:
type: string
description: The ID of the Initiating Participant
- name: X-market
in: header
required: false
schema:
type: string
description: The market type that the request applies.
- name: Authorization
in: header
required: true
schema:
type: string
responses:
'200':
description: Successful reponse with the Transportation facilities report
content:
application/json:
example:
transactionId: c631b30e-2ce1-4647-946f-be2d04291107
data:
Facilities:
- FacilityId: 530001
FacilityName: MAPS
FacilityDescription: Moomba to Adelaide Pipeline System
FacilityType: Pipeline
OperatorId: '584'
OperatorName: Epic Energy
EffectiveDate: '2018-02-28T02:00:00Z'
VersionDatetime: '2018-02-01T02:23:45Z'
LastChanged: '2018-02-02T02:23:45Z'
- FacilityId: 540001
FacilityName: MSP
FacilityDescription: Moomba to Sydney Pipeline
FacilityType: Pipeline
OperatorId: '590'
OperatorName: APA
EffectiveDate: '2018-02-28T02:00:00Z'
VersionDatetime: '2018-02-01T02:23:45Z'
LastChanged: '2018-02-02T02:23:45Z'
errors: []
'400':
description: The service cannot be found for the endpoint reference (EPR)
content:
application/json:
example:
Fault:
'401':
description: This response is provided when "Authorisation" is missing from the header OR user/password
is incorrect/not provided OR user account is locked out.
content:
application/json:
example:
Exception: Unauthorized:Invalid UserName or Password
'403':
description: This response is provided when there is an invalid Role i.e. user does not have
permission to submit this request.
'404':
description: This response is provided when the resource is missing from the URL or the URL
is incorrect.
content:
application/json:
example:
Exception: 'Resources for the endpoint URI not found. Endpoint URI: '
'405':
description: Invalid Method used (e.g. GET used instead of POST)
content:
application/json:
example:
Exception: 'Input request HTTP method is but operation accepts only: []'
'411':
description: This response is provided when "Content-Length" is missing from the Header
'422':
description: This response is provided when any there are any Business validation failures,
then entire submission is rejected.
'500':
description: e-Hub is operational but downstream systems are not available.
content:
application/json:
example:
Exception: Application Unavailable
'503':
description: Exceeds throttling limits OR SSL Certificate authentication validation failed
content:
application/json:
example:
Exception: 'Service invocation for API was rejected based on policy violation OR Error
message: javax.net.ssl.SSLHandshakeException: Received fatal alert: bad_certificate'
/reportCapacityTransferAndAuctionNotice:
get:
operationId: theReportNotifiesParticipantsWhenTheMarketDelayOrCancellationProcessIsTriggered
summary: The report notifies participants when the market delay or cancellation process is triggered.
tags:
- Capacity
description: The report notifies participants when the market delay or cancellation process is triggered.
parameters:
- name: FacilityId
in: query
required: false
schema:
type: integer
description: The unique AEMO defined Facility identifier.
- name: Markets
in: query
required: false
schema:
type: string
description: The market that has triggered the notice, for example CTP or DAA.
- name: ChangedAfter
in: query
required: false
schema:
type: string
description: Changed After Date
- name: FromGasDate
in: query
required: false
schema:
type: string
description: One calendar month from request date
- name: ToGasDate
in: query
required: false
schema:
type: string
description: Request date
- name: X-initiatingParticipantID
in: header
required: true
schema:
type: string
description: The ID of the Initiating Participant
- name: X-market
in: header
required: false
schema:
type: string
description: The market type that the request applies.
- name: Authorization
in: header
required: true
schema:
type: string
responses:
'200':
description: Successful reponse with report on market delay or cancellation
content:
application/json:
example:
transactionId: 27d225a6-6c9a-4081-81dc-eb643fdd2a4d
data:
Notices:
- NoticeId: 123
NoticeDate: '2018-04-30T02:34:56Z'
GasDate: '2018-04-30T02:00:00Z'
FacilityId: ''
FacilityName: ''
Market: CTP
NoticeType: Delay
Description: Market has been delayed by 2 hours due to system issue
LastChanged: '2018-05-01T02:23:45Z'
errors: ''
'400':
description: The service cannot be found for the endpoint reference (EPR)
content:
application/json:
example:
Fault:
'401':
description: This response is provided when "Authorisation" is missing from the header OR user/password
is incorrect/not provided OR user account is locked out.
content:
application/json:
example:
Exception: Unauthorized:Invalid UserName or Password
'403':
description: This response is provided when there is an invalid Role i.e. user does not have
permission to submit this request.
'404':
description: This response is provided when the resource is missing from the URL or the URL
is incorrect.
content:
application/json:
example:
Exception: 'Resources for the endpoint URI not found. Endpoint URI: '
'405':
description: Invalid Method used (e.g. GET used instead of POST)
content:
application/json:
example:
Exception: 'Input request HTTP method is but operation accepts only: []'
'411':
description: This response is provided when "Content-Length" is missing from the Header
'422':
description: This response is provided when any there are any Business validation failures,
then entire submission is rejected.
'500':
description: e-Hub is operational but downstream systems are not available.
content:
application/json:
example:
Exception: Application Unavailable
'503':
description: Exceeds throttling limits OR SSL Certificate authentication validation failed
content:
application/json:
example:
Exception: 'Service invocation for API was rejected based on policy violation OR Error
message: javax.net.ssl.SSLHandshakeException: Received fatal alert: bad_certificate'
components:
securitySchemes:
apiKeyHeader:
type: apiKey
name: Ocp-Apim-Subscription-Key
in: header
apiKeyQuery:
type: apiKey
name: subscription-key
in: query
security:
- {}
- apiKeyHeader: []
- apiKeyQuery: []
tags:
- name: Capacity
description: Capacity