openapi: 3.1.0
info:
  title: Energy Transfer Messenger+ 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.
  - name: Pipelines
    description: Retrieve pipeline information and status.
  - name: Schedules
    description: Access gas scheduling and capacity data.
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
  /schedules:
    get:
      operationId: listSchedules
      summary: List schedules
      description: >-
        Retrieves a list of confirmed gas scheduling data including
        scheduled quantities and flow dates.
      tags:
        - Schedules
      responses:
        '200':
          description: Success
  /pipelines:
    get:
      operationId: listPipelines
      summary: List pipelines
      description: >-
        Retrieves a list of Energy Transfer pipelines with capacity,
        status, and operational details.
      tags:
        - Pipelines
      responses:
        '200':
          description: Success
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer