openapi: 3.1.0
info:
  title: Energy Transfer Messenger+ Nominations API
  description: The Energy Transfer Messenger+ API provides programmatic access to Energy Transfer's pipeline messaging and gas scheduling platform. The API enables partners and shippers to manage gas nominations, scheduling, and pipeline capacity through automated integrations, reducing processing times from 90 minutes to approximately 12 minutes.
  version: '1.0'
servers:
- url: https://dev.messenger.energytransfer.com
tags:
- name: Nominations
  description: Manage gas pipeline nominations.
paths:
  /nominations:
    get:
      operationId: listNominations
      summary: List nominations
      description: Retrieves a list of gas pipeline nominations submitted by the authenticated shipper, including status, volumes, and pipeline details.
      tags:
      - Nominations
      responses:
        '200':
          description: Success
    post:
      operationId: createNomination
      summary: Create a nomination
      description: Submits a new gas pipeline nomination with specified volumes, receipt and delivery points, and scheduling details.
      tags:
      - Nominations
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                pipelineId:
                  type: string
                volume:
                  type: number
                receiptPoint:
                  type: string
                deliveryPoint:
                  type: string
      responses:
        '201':
          description: Nomination created successfully
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer