openapi: 3.2.0
info:
  title: ISO New England Web Services API v1.1 Hourlyfinalreserveprice API
  version: '1.1'
  description: RESTful interface to ISO New England energy and market data. This OpenAPI document was DERIVED by API Evangelist from ISO New England's own published, machine-generated Enunciate technical documentation at https://webservices.iso-ne.com/docs/v1.1/ and the two XML Schemas it publishes (ns0.xsd, ns1.xsd, saved verbatim under schemas/). ISO New England does not publish an OpenAPI definition; the only provider-published machine-readable description of the interface is a WADL at https://webservices.iso-ne.com/api/v1.1?_wadl&_type=xml, which sits behind the same HTTP Basic authentication as the API and returned HTTP 401 to anonymous probes. Every path, method, parameter, description, media type and schema in this document is copied from the provider's published sources; nothing was invented. Each operation carries x-evidence naming the exact documentation page it came from. All feeds are available in XML and JSON, selected by adding a .xml or .json extension to the request URL or by sending an Accept header of application/xml or application/json.
  contact:
    name: ISO New England Ask ISO
    url: https://askiso.iso-ne.com/s/
  x-provenance:
    method: derived
    derived_by: API Evangelist enrichment pipeline
    derived_on: '2026-07-27'
    sources:
    - https://webservices.iso-ne.com/docs/v1.1/
    - https://webservices.iso-ne.com/docs/v1.1/ns0.xsd
    - https://webservices.iso-ne.com/docs/v1.1/ns1.xsd
    - https://www.iso-ne.com/participate/support/web-services-data
    not_provider_published: true
    note: Derived from provider-published HTML documentation and XSDs. Not an ISO New England artifact.
servers:
- url: https://webservices.iso-ne.com/api/v1.1
  description: Production base path (HTTP Basic over SSL)
security:
- basicAuth: []
tags:
- name: hourlyfinalreserveprice
  description: 7 path template(s) under /hourlyfinalreserveprice in the published ISO New England Web Services API v1.1 documentation.
paths:
  /hourlyfinalreserveprice:
    get:
      operationId: getHourlyfinalreserveprice
      summary: Default resource
      description: Default resource. Redirects to Hourly Final Reserve Price.
      tags:
      - hourlyfinalreserveprice
      responses:
        '200':
          description: Successful response.
          content:
            application/xml:
              schema:
                description: Response payload is not described in the published documentation.
            application/json:
              schema:
                description: Response payload is not described in the published documentation.
        '401':
          description: Unauthorized - HTTP Basic credentials from an ISO Express account are required. Verified by anonymous probe on 2026-07-27.
      x-evidence:
        source: https://webservices.iso-ne.com/docs/v1.1/rest.hourlyfinalreserveprice.html
        harvested: '2026-07-27'
  /hourlyfinalreserveprice/current:
    get:
      operationId: getHourlyfinalreservepriceCurrent
      summary: Get the current Hourly Final Reserve Prices for all locations
      description: Get the current Hourly Final Reserve Prices for all locations.
      tags:
      - hourlyfinalreserveprice
      responses:
        '200':
          description: a FinalHourlyReservePricesElement containing the current Hourly Final Reserve Prices.
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/FinalHourlyReservePrices'
            application/json:
              schema:
                $ref: '#/components/schemas/FinalHourlyReservePrices'
        '401':
          description: Unauthorized - HTTP Basic credentials from an ISO Express account are required. Verified by anonymous probe on 2026-07-27.
      x-evidence:
        source: https://webservices.iso-ne.com/docs/v1.1/rest.hourlyfinalreserveprice.current.html
        harvested: '2026-07-27'
      x-xml-element: FinalHourlyReservePrices
  /hourlyfinalreserveprice/current/locationType/{locationType}:
    get:
      operationId: getHourlyfinalreservepriceCurrentLocationTypeByLocationType
      summary: Get the current Hourly Final Reserve Prices for a given location type
      description: Get the current Hourly Final Reserve Prices for a given location type.
      tags:
      - hourlyfinalreserveprice
      responses:
        '200':
          description: a FinalHourlyReservePricesElement containing the current Hourly Final Reserve Prices for the given location.
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/FinalHourlyReservePrices'
            application/json:
              schema:
                $ref: '#/components/schemas/FinalHourlyReservePrices'
        '401':
          description: Unauthorized - HTTP Basic credentials from an ISO Express account are required. Verified by anonymous probe on 2026-07-27.
      x-evidence:
        source: https://webservices.iso-ne.com/docs/v1.1/rest.hourlyfinalreserveprice.current.locationType.locationType.html
        harvested: '2026-07-27'
      x-xml-element: FinalHourlyReservePrices
      parameters:
      - name: locationType
        in: path
        required: true
        schema:
          type: string
        description: The locationType
  /hourlyfinalreserveprice/current/reserveZone/{reserveZoneId}:
    get:
      operationId: getHourlyfinalreservepriceCurrentReserveZoneByReserveZoneId
      summary: Get the current Hourly Final Reserve Prices for a given location
      description: Get the current Hourly Final Reserve Prices for a given location.
      tags:
      - hourlyfinalreserveprice
      responses:
        '200':
          description: a FinalHourlyReservePriceElement containing the current Hourly Final Reserve Price for the given ReserveZoneId.
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/FinalHourlyReservePrice'
            application/json:
              schema:
                $ref: '#/components/schemas/FinalHourlyReservePrice'
        '401':
          description: Unauthorized - HTTP Basic credentials from an ISO Express account are required. Verified by anonymous probe on 2026-07-27.
      x-evidence:
        source: https://webservices.iso-ne.com/docs/v1.1/rest.hourlyfinalreserveprice.current.reserveZone.reserveZoneId.html
        harvested: '2026-07-27'
      x-xml-element: FinalHourlyReservePrice
      parameters:
      - name: reserveZoneId
        in: path
        required: true
        schema:
          type: string
  /hourlyfinalreserveprice/day/{day}:
    get:
      operationId: getHourlyfinalreservepriceDayByDay
      summary: Get an entire days Hourly Final Reserve Prices for a given Date
      description: Get an entire days Hourly Final Reserve Prices for a given Date. Only the past [?] days are supported.
      tags:
      - hourlyfinalreserveprice
      responses:
        '200':
          description: a FinalHourlyReservePricesElement containing the Hourly Final Reserve Prices.
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/FinalHourlyReservePrices'
            application/json:
              schema:
                $ref: '#/components/schemas/FinalHourlyReservePrices'
        '401':
          description: Unauthorized - HTTP Basic credentials from an ISO Express account are required. Verified by anonymous probe on 2026-07-27.
      x-evidence:
        source: https://webservices.iso-ne.com/docs/v1.1/rest.hourlyfinalreserveprice.day.day.html
        harvested: '2026-07-27'
      x-xml-element: FinalHourlyReservePrices
      parameters:
      - name: day
        in: path
        required: true
        schema:
          type: string
        description: The day to retrieve data for (YYYYMMDD)
  /hourlyfinalreserveprice/day/{day}/reserveZone/{reserveZoneId}:
    get:
      operationId: getHourlyfinalreservepriceDayByDayReserveZoneByReserveZoneId
      summary: Get an entire days Hourly Final Reserve Prices for a given Reserve Zone
      description: Get an entire days Hourly Final Reserve Prices for a given Reserve Zone. Only the past [?] days are supported.
      tags:
      - hourlyfinalreserveprice
      responses:
        '200':
          description: a FinalHourlyReservePricesElement containing the Hourly Final Reserve Prices.
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/FinalHourlyReservePrices'
            application/json:
              schema:
                $ref: '#/components/schemas/FinalHourlyReservePrices'
        '401':
          description: Unauthorized - HTTP Basic credentials from an ISO Express account are required. Verified by anonymous probe on 2026-07-27.
      x-evidence:
        source: https://webservices.iso-ne.com/docs/v1.1/rest.hourlyfinalreserveprice.day.day.reserveZone.reserveZoneId.html
        harvested: '2026-07-27'
      x-xml-element: FinalHourlyReservePrices
      parameters:
      - name: day
        in: path
        required: true
        schema:
          type: string
        description: The day to retrieve data for (YYYYMMDD)
      - name: reserveZoneId
        in: path
        required: true
        schema:
          type: string
        description: The reserve Zone Id
  /hourlyfinalreserveprice/info:
    get:
      operationId: getHourlyfinalreservepriceInfo
      summary: Get the Service Info for Hourly Final Reserve Price
      description: Get the Service Info for Hourly Final Reserve Price.
      tags:
      - hourlyfinalreserveprice
      responses:
        '200':
          description: the ServiceInfoElement for Hourly Final Reserve Price.
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/ServiceInfo'
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceInfo'
        '401':
          description: Unauthorized - HTTP Basic credentials from an ISO Express account are required. Verified by anonymous probe on 2026-07-27.
      x-evidence:
        source: https://webservices.iso-ne.com/docs/v1.1/rest.hourlyfinalreserveprice.info.html
        harvested: '2026-07-27'
      x-xml-element: ServiceInfo
components:
  schemas:
    ReservePrice:
      type: object
      properties:
        BeginDate:
          type: string
          format: date-time
        ReserveZoneId:
          type: integer
        ReserveZoneName:
          type: string
        TenMinSpinRequirement:
          type: number
        Total10MinRequirement:
          type: number
        Total30MinRequirement:
          type: number
        TmsrDesignatedMw:
          type: number
        TmnsrDesignatedMw:
          type: number
        TmorDesignatedMw:
          type: number
        TmsrClearingPrice:
          type: number
        TmnsrClearingPrice:
          type: number
        TmorClearingPrice:
          type: number
        IntervalBeginDate:
          type: string
          format: date-time
      required:
      - BeginDate
      x-xsd-source: schemas/iso-new-england-web-services-ns0.xsd#type_ReservePrice
    FinalHourlyReservePrices:
      type: object
      properties:
        FinalHourlyReservePrice:
          type: array
          items:
            $ref: '#/components/schemas/FinalHourlyReservePrice'
      x-xsd-source: schemas/iso-new-england-web-services-ns0.xsd#type_FinalHourlyReservePrices
    ServiceInfo:
      type: object
      properties:
        LatestBeginDate:
          type: string
          format: date-time
        CreationDate:
          type: string
          format: date-time
      required:
      - LatestBeginDate
      - CreationDate
      x-xsd-source: schemas/iso-new-england-web-services-ns0.xsd#type_ServiceInfo
    FinalHourlyReservePrice:
      $ref: '#/components/schemas/ReservePrice'
      x-xsd-source: schemas/iso-new-england-web-services-ns0.xsd#type_FinalHourlyReservePrice
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: HTTP Basic Authentication over SSL. Credentials come from a free, self-serve ISO Express account; ISO New England states that ISO Express account holders are automatically granted access to the public data feeds. See https://www.iso-ne.com/participate/applications-status-changes/access-software-systems