openapi: 3.0.1 info: title: CapacityAuction description: ' ## Introduction The Capacity Auction 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: View API Docs' version: v1 x-origin: - format: openapi version: '3.0' source: AEMO API Management developer portal url: https://dev.aemo.com.au/developer/apis/capacityAuction-v1/operations?api-version=2022-04-01-preview servers: - url: https://api-prd.aemo.local/ws/gsh/capacityAuction paths: /GasFuture: get: operationId: getGSHFutureData summary: Get GSH future data tags: - CapacityAuction description: Allows auction participants to retrieve GSH Physical Gas Future Data 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 responses: '200': description: Success response with future data content: application/json: example: transactionId: 296432aa-7cc6-43e5-b611-0c8cbd092748 data: CallSuccessful: true CallResponseMessage: GSH Physical Gas Future Data Request completed. ItemList: - MarketId: GSH RecordId: 33983 ParticipantId: '2012' GasFutureId: ASX-AEMO-DEMO-344 ProductGroupCode: GAS-WAL ProductTypeCode: Gas - NG Months DeliveryPoint: WAL HP Trade Point StartDate: '2022-07-01T12:00:00Z' EndDate: '2022-07-31T12:00:00Z' TradeType: BUY Price: 3 Volume: 4 TradeValue: 12 Status: PENDING ValidationMsg: '' SubmittedTime: '2022-06-07T10:56:37Z' LastChanged: '2022-06-07T10:56:37Z' - MarketId: GSH RecordId: 33982 ParticipantId: '2012' GasFutureId: ASX-AEMO-DEMO-344 ProductGroupCode: GAS-WAL ProductTypeCode: Gas - NG Months DeliveryPoint: WAL HP Trade Point StartDate: '2022-07-01T12:00:00Z' EndDate: '2022-07-31T12:00:00Z' TradeType: BUY Price: 3 Volume: 4 TradeValue: 12 Status: OVERRIDE ValidationMsg: '' SubmittedTime: '2022-06-07T12:20:07Z' LastChanged: '2022-06-07T10:56:37Z' 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 missing from URL or 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: APIM 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' /bidProfile: post: operationId: retrieveASpecificBidProfile summary: Retrieve a specific bid profile tags: - CapacityAuction description: Allows auction participants to retrieve a specific bid profile for a given gas date parameters: - name: GasDate in: query required: false schema: type: string description: Request date - name: SubmittedAt in: query required: false schema: type: string description: If not supplied, then the latest successful bid submission for each gas date in a specified range is returned. - 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: Success reponse with report data content: application/json: example: transactionId: 27d225a6-6c9a-4081-81dc-eb643fdd2a8f data: - BidProfileList: - GasDate: '2018-05-01T12:00:00Z' SubmittedAt: '2018-05-02T12:00:00Z' Bids: - BidId: '2018-05-01T12:00:00Z' Products: - FacilityId: 530001 FacilityName: MAP FacilityDescription: Moomba to Adelaide Pipeline System AuctionProductTypeId: BACKHAUL ReceiptPointId: 30001 ReceiptPointName: RP 1 ReceiptPointDWGMCompanyIdReference: 123 ReceiptPointDWGMCompanyNameReference: ABC Trading Pty Ltd ReceiptPointDWGMMIRNReference: 200001PC ReceiptPointDWGMDescriptionReference: Connection between A and B DeliveryPointId: 30002 DeliveryPointName: DP 1 DeliveryPointDWGMCompanyIdReference: 123 DeliveryPointDWGMCompanyNameReference: Clean Energy Pty Ltd DeliveryPointDWGMMIRNReference: 200002PC DeliveryPointDWGMDescriptionReference: Connection between X and Y ServiceReference: SR000001 Steps: - CumulativeStepQuantity: 123 StepPrice: '2032-04-01' '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 missing from URL or 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' /bidSubmissionHistory: post: operationId: retrieveBidSubmissions summary: Retrieve bid submissions tags: - CapacityAuction description: Allows auction participants to retrieve metadata for all successful bid submissions for a given gas date range. parameters: - name: FromGasDate in: query required: true schema: type: string description: One calendar month from request date - name: ToGasDate in: query required: true 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: Success reponse with report data content: application/json: example: transactionId: 27d225a6-6c9a-4081-81dc-eb643fdd2a8f data: - GasDays: - GasDate: '2018-05-09T02:00:00Z' Submissions: - SubmissionTime: '2018-02-23T02:34:45Z' SubmittingUserId: jsmith '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 missing from URL or 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' /bidProfileSubmission: post: operationId: submitBidsForTheDayAheadAuction summary: Submit bids for the Day Ahead Auction. tags: - CapacityAuction description: "Allows auction participants to submit bids for the Day Ahead Auction.\nMultiple bids\ \ may be submitted in a single bid profile. However, all bids must pass validation otherwise the\ \ entire transaction will be rejected.\nThe latest bid profile submission will be used as the\ \ overall current bidding position for the specified date range.\n\n A previously submitted bid\ \ can be cancelled by submitting an empty bid profile for the same 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: FromGasDate: '2018-05-01T12:00:00Z' ToGasDate: '2018-05-02T12:00:00Z' Bids: - BidId: '2018-05-01T12:00:00Z' Products: - FacilityId: 530001 AuctionProductTypeId: BACKHAUL ReceiptPointId: 30001 ReceiptPointDWGMCompanyIdReference: 123 ReceiptPointDWGMMIRNReference: 200001PC DeliveryPointId: 30002 DeliveryPointDWGMCompanyIdReference: 123 DeliveryPointDWGMMIRNReference: 200002PC ServiceReference: SR000001 Steps: - CumulativeStepQuantity: 123 StepPrice: '2032-04-01' responses: '200': description: Successful reponse with Facilites report content: application/json: example: Successful reponse with Facilites report - MOCK: '' '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 missing from URL or 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' /GasFutureUpload: post: operationId: submitFutureTradeData summary: Submit future trade data tags: - CapacityAuction description: Allows auction participants to submit the GSH Physical Gas Future Data 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: - GasFutureId: ASX-AEMO-DEMO-344 StartDate: '2022-07-01' EndDate: '2022-07-31' TradeType: BUY Price: '3' Volume: '4' responses: '200': description: Success response with future data content: application/json: example: transactionId: 1ff59f8a-4057-4644-9fec-7aea321c96ee data: CallSuccessful: true CallResponseMessage: GSH Physical Gas Future Data Request completed. ItemList: - MarketId: GSH RecordId: 33984 ParticipantId: '2012' GasFutureId: ASX-AEMO-DEMO-344 ProductGroupCode: GAS-WAL ProductTypeCode: Gas - NG Months DeliveryPoint: WAL HP Trade Point StartDate: '2022-07-01T12:00:00Z' EndDate: '2022-07-31T12:00:00Z' TradeType: BUY Price: 3 Volume: 4 TradeValue: 12 Status: PENDING ValidationMsg: '' SubmittedTime: '2022-06-08T12:00:29Z' LastChanged: '2022-06-08T12:00:29Z' - MarketId: GSH RecordId: 33983 ParticipantId: '2012' GasFutureId: ASX-AEMO-DEMO-344 ProductGroupCode: GAS-WAL ProductTypeCode: Gas - NG Months DeliveryPoint: WAL HP Trade Point StartDate: '2022-07-01T12:00:00Z' EndDate: '2022-07-31T12:00:00Z' TradeType: BUY Price: 3 Volume: 4 TradeValue: 12 Status: OVERRIDE ValidationMsg: '' SubmittedTime: '2022-06-07T10:56:37Z' LastChanged: '2022-06-08T12:00:29Z' - MarketId: GSH RecordId: 33982 ParticipantId: '2012' GasFutureId: ASX-AEMO-DEMO-344 ProductGroupCode: GAS-WAL ProductTypeCode: Gas - NG Months DeliveryPoint: WAL HP Trade Point StartDate: '2022-07-01T12:00:00Z' EndDate: '2022-07-31T12:00:00Z' TradeType: BUY Price: 3 Volume: 4 TradeValue: 12 Status: OVERRIDE ValidationMsg: '' SubmittedTime: '2022-06-07T12:20:07Z' LastChanged: '2022-06-07T10:56:37Z' - MarketId: GSH RecordId: 33981 ParticipantId: '2012' GasFutureId: '' ProductGroupCode: GAS-WAL ProductTypeCode: Gas - NG Months DeliveryPoint: WAL HP Trade Point StartDate: '2022-07-01T12:00:00Z' EndDate: '2022-07-31T12:00:00Z' TradeType: SELL Price: 126 Volume: 126 TradeValue: 15876 Status: FAIL ValidationMsg: Enter Gas future ID for the final transfer SubmittedTime: '2022-06-07T12:19:56Z' LastChanged: '2022-06-07T12:19:56Z' - MarketId: GSH RecordId: 33980 ParticipantId: '2012' GasFutureId: '' ProductGroupCode: GAS-WAL ProductTypeCode: Gas - NG Months DeliveryPoint: WAL HP Trade Point StartDate: '2022-07-01T12:00:00Z' EndDate: '2022-07-31T12:00:00Z' TradeType: SELL Price: 125 Volume: 125 TradeValue: 15625 Status: FAIL ValidationMsg: Enter Gas future ID for the final transfer SubmittedTime: '2022-06-07T12:18:37Z' LastChanged: '2022-06-07T12:18:37Z' - MarketId: GSH RecordId: 33979 ParticipantId: '2012' GasFutureId: '' ProductGroupCode: GAS-WAL ProductTypeCode: Gas - NG Months DeliveryPoint: WAL HP Trade Point StartDate: '2022-07-01T12:00:00Z' EndDate: '2022-07-31T12:00:00Z' TradeType: BUY Price: 123 Volume: 123 TradeValue: 15129 Status: FAIL ValidationMsg: Enter Gas future ID for the final transfer SubmittedTime: '2022-06-07T12:15:27Z' LastChanged: '2022-06-07T12:15:27Z' - MarketId: GSH RecordId: 33978 ParticipantId: '2012' GasFutureId: '' ProductGroupCode: GAS-WAL ProductTypeCode: Gas - NG Months DeliveryPoint: WAL HP Trade Point StartDate: '2022-07-01T12:00:00Z' EndDate: '2022-07-31T12:00:00Z' TradeType: BUY Price: 33 Volume: 3333 TradeValue: 109989 Status: FAIL ValidationMsg: Enter Gas future ID for the final transfer SubmittedTime: '2022-06-07T12:11:41Z' LastChanged: '2022-06-07T12:11:41Z' - MarketId: GSH RecordId: 33977 ParticipantId: '2012' GasFutureId: ASX-AEMO-DEMO-344 ProductGroupCode: GAS-WAL ProductTypeCode: Gas - NG Months DeliveryPoint: WAL HP Trade Point StartDate: '2022-06-01T12:00:00Z' EndDate: '2022-06-30T12:00:00Z' TradeType: BUY Price: 3 Volume: 4 TradeValue: 12 Status: FAIL ValidationMsg: 'Enter a valid start date in the following format : YYYY/MM/DD. e.g: 2022/07/01' SubmittedTime: '2022-06-07T11:55:54Z' LastChanged: '2022-06-07T11:55:54Z' - MarketId: GSH RecordId: 33976 ParticipantId: '2012' GasFutureId: ASX-AEMO-DEMO-344 ProductGroupCode: GAS-WAL ProductTypeCode: Gas - NG Months DeliveryPoint: WAL HP Trade Point StartDate: '2022-06-01T12:00:00Z' EndDate: '2022-06-30T12:00:00Z' TradeType: BUY Price: 3 Volume: 4 TradeValue: 12 Status: FAIL ValidationMsg: 'Enter a valid start date in the following format : YYYY/MM/DD. e.g: 2022/07/01' SubmittedTime: '2022-06-07T11:55:25Z' LastChanged: '2022-06-07T11:55:25Z' - MarketId: GSH RecordId: 33975 ParticipantId: '2012' GasFutureId: ASX-AEMO-DEMO-344 ProductGroupCode: GAS-WAL ProductTypeCode: Gas - NG Months DeliveryPoint: WAL HP Trade Point StartDate: '2022-06-01T12:00:00Z' EndDate: '2022-06-30T12:00:00Z' TradeType: BUY Price: 3 Volume: 4 TradeValue: 12 Status: FAIL ValidationMsg: 'Enter a valid start date in the following format : YYYY/MM/DD. e.g: 2022/07/01' SubmittedTime: '2022-06-07T11:54:58Z' LastChanged: '2022-06-07T11:54:58Z' - MarketId: GSH RecordId: 33974 ParticipantId: '2012' GasFutureId: '' ProductGroupCode: GAS-WAL ProductTypeCode: Gas - NG Months DeliveryPoint: WAL HP Trade Point StartDate: '2022-07-01T12:00:00Z' EndDate: '2022-07-31T12:00:00Z' TradeType: BUY Price: 222 Volume: 222 TradeValue: 49284 Status: FAIL ValidationMsg: Enter Gas future ID for the final transfer SubmittedTime: '2022-06-07T11:49:29Z' LastChanged: '2022-06-07T11:49:29Z' - MarketId: GSH RecordId: 33973 ParticipantId: '2012' GasFutureId: ASX-AEMO-DEMO-344 ProductGroupCode: GAS-WAL ProductTypeCode: Gas - NG Months DeliveryPoint: WAL HP Trade Point StartDate: '2022-07-01T12:00:00Z' EndDate: '2022-07-31T12:00:00Z' TradeType: BUY Price: 3 Volume: 4 TradeValue: 12 Status: OVERRIDE ValidationMsg: '' SubmittedTime: '2022-06-07T11:30:04Z' LastChanged: '2022-06-07T12:20:07Z' - MarketId: GSH RecordId: 33963 ParticipantId: '2012' GasFutureId: ASX-AEMO-0012 ProductGroupCode: GAS-WAL ProductTypeCode: Gas - NG Months DeliveryPoint: WAL HP Trade Point StartDate: '2022-07-01T12:00:00Z' EndDate: '2022-07-31T12:00:00Z' TradeType: BUY Price: 2 Volume: 2 TradeValue: 4 Status: PENDING ValidationMsg: '' SubmittedTime: '2022-06-02T10:41:56Z' LastChanged: '2022-06-02T10:41:56Z' errors: [] '400': description: '400' content: application/json: example: Fault: '401': description: This response is provided when "Authorization" 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 missing from URL or 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: APIM 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: CapacityAuction description: CapacityAuction