Leap group-dispatches API

openapi: 3.2.0
info:
  contact:
    email: apiteam@leap.energy
  description: Receive dispatches through Leap Dispatch API V2
  termsOfService: https://leap.energy/terms/terms-of-service
  title: Group Dispatches API
  version: '2'
servers:
- url: https://api.staging.leap.energy/v2
- url: https://api.leap.energy/v2
security:
- http: []
tags:
- description: Endpoints for group dispatches
  name: group-dispatches
paths:
  /dispatch/group/search:
    post:
      description: Search group dispatches that match the input filters
      operationId: searchGroupDispatches
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchGroupDispatchEventRequest'
        description: Search group dispatch request input
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchGroupDispatchEventResponse'
          description: The group dispatches that match the search input
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Request could not be parsed or is invalid
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: No access to this resource
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Resource not found
        5XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unexpected error
      summary: Search group dispatches
      tags:
      - group-dispatches
  /dispatch/group/webhook:
    delete:
      description: Remove an existing webhook URL for group dispatches
      operationId: deleteGroupDispatchWebhook
      responses:
        '204':
          description: Webhook URL has been removed
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: No access to this resource
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Resource not found
        5XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unexpected error
      summary: Delete group webhook URL
      tags:
      - group-dispatches
    get:
      description: Retrieve the registered webhook URL for group dispatches
      operationId: getGroupDispatchWebhook
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Webhook'
          description: Success
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: No access to this resource
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Resource not found
        5XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unexpected error
      summary: Get group webhook URL
      tags:
      - group-dispatches
    put:
      description: Create or update an existing webhook URL for group dispatches
      operationId: createOrUpdateGroupDispatchWebhook
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Webhook'
        description: Webhook object that needs to be registered for this account
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Webhook'
          description: Webhook URL updated
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Request could not be parsed or is invalid
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: No access to this resource
        5XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unexpected error
      summary: Set group webhook URL
      tags:
      - group-dispatches
      x-codegen-request-body-name: apiWebhook
  /dispatch/group/webhook/integration_test:
    post:
      description: Create test notification that will trigger a webhook call with the corresponding group dispatch notification data
      operationId: triggerTestGroupDispatchNotification
      requestBody:
        content:
          application/json:
            examples:
              CAISO - CCA Capacity Test:
                value:
                  group_dispatches:
                  - market_group_id: 9d1a7aae-24e5-455f-91e9-e0f5f145f2ae
                    meter_ids:
                    - beae2779-e392-4f00-b0cf-32e716204f78
                    - dd21c76c-7126-4ef7-b0a6-f190fad300b2
                    timeslots:
                    - market_group_event_id: 1acfced0-16f4-4fb7-b72e-5ff939ae541e
                      start_time: 2023-07-21 00:00:00+00:00
                      end_time: 2023-07-21 01:00:00+00:00
                      energy_kw: 100
                      nomination_kw: 100
                      cancelled: false
                      programs:
                      - CCA
                      priority: 1
                      is_voluntary: false
                      performance_compensation_cap: up-to-nomination
                      dispatch_event_types:
                      - capacity-test
                    - market_group_event_id: 2ad4bbde-36ee-401f-92b8-c58aa17aa71d
                      start_time: 2023-07-21 01:00:00+00:00
                      end_time: 2023-07-21 02:00:00+00:00
                      energy_kw: 100
                      nomination_kw: 100
                      cancelled: false
                      programs:
                      - CCA
                      priority: 1
                      is_voluntary: false
                      performance_compensation_cap: up-to-nomination
                      dispatch_event_types:
                      - capacity-test
              CAISO - CCA Market Award:
                value:
                  group_dispatches:
                  - market_group_id: 9d1a7aae-24e5-455f-91e9-e0f5f145f2ae
                    meter_ids:
                    - beae2779-e392-4f00-b0cf-32e716204f78
                    - dd21c76c-7126-4ef7-b0a6-f190fad300b2
                    timeslots:
                    - market_group_event_id: 3acfced0-16f4-4fb7-b72e-5ff939ae541e
                      start_time: 2023-07-21 00:00:00+00:00
                      end_time: 2023-07-21 01:00:00+00:00
                      energy_kw: 80
                      nomination_kw: 100
                      cancelled: false
                      programs:
                      - CCA
                      priority: 2
                      is_voluntary: false
                      performance_compensation_cap: up-to-site-load
                      dispatch_event_types:
                      - day-ahead
                    - market_group_event_id: 4ad4bbde-36ee-401f-92b8-c58aa17aa71d
                      start_time: 2023-07-21 01:00:00+00:00
                      end_time: 2023-07-21 02:00:00+00:00
                      energy_kw: 80
                      nomination_kw: 100
                      cancelled: false
                      programs:
                      - CCA
                      priority: 2
                      is_voluntary: false
                      performance_compensation_cap: up-to-site-load
                      dispatch_event_types:
                      - day-ahead
              CAISO - ELRP:
                value:
                  group_dispatches:
                  - market_group_id: 9d1a7aae-24e5-455f-91e9-e0f5f145f2ae
                    meter_ids:
                    - beae2779-e392-4f00-b0cf-32e716204f78
                    - dd21c76c-7126-4ef7-b0a6-f190fad300b2
                    timeslots:
                    - market_group_event_id: 5ad4bbde-36ee-401f-92b8-c58aa17aa71d
                      start_time: 2023-07-21 00:00:00+00:00
                      end_time: 2023-07-21 04:00:00+00:00
                      energy_kw: null
                      nomination_kw: 100
                      cancelled: false
                      programs:
                      - ELRP
                      priority: 3
                      is_voluntary: true
                      performance_compensation_cap: grid-exports-allowed
                      dispatch_event_types:
                      - standard
              CAISO - DSGS Option 3:
                value:
                  group_dispatches:
                  - market_group_id: 9d1a7aae-24e5-455f-91e9-e0f5f145f2ae
                    meter_ids:
                    - beae2779-e392-4f00-b0cf-32e716204f78
                    - dd21c76c-7126-4ef7-b0a6-f190fad300b2
                    timeslots:
                    - market_group_event_id: 6ad4bbde-36ee-401f-92b8-c58aa17aa71d
                      start_time: 2023-07-21 00:00:00+00:00
                      end_time: 2023-07-21 02:00:00+00:00
                      energy_kw: 100
                      nomination_kw: 100
                      cancelled: false
                      programs:
                      - CEC-DSGS
                      priority: 4
                      is_voluntary: true
                      performance_compensation_cap: grid-exports-allowed
                      dispatch_event_types:
                      - standard
              CAISO - DSGS Option 4:
                value:
                  group_dispatches:
                  - market_group_id: 9d1a7aae-24e5-455f-91e9-e0f5f145f2ae
                    meter_ids:
                    - beae2779-e392-4f00-b0cf-32e716204f78
                    - dd21c76c-7126-4ef7-b0a6-f190fad300b2
                    timeslots:
                    - market_group_event_id: 6ad4bbde-36ee-401f-92b8-c58aa17aa71d
                      start_time: 2023-07-21 00:00:00+00:00
                      end_time: 2023-07-21 02:00:00+00:00
                      energy_kw: 10
                      nomination_kw: 10
                      cancelled: false
                      programs:
                      - CEC-DSGS-OPTION4
                      priority: 4
                      is_voluntary: false
                      performance_compensation_cap: grid-exports-allowed
                      dispatch_event_types:
                      - standard
              ERCOT - ERS:
                value:
                  group_dispatches:
                  - market_group_id: 9d1a7aae-24e5-455f-91e9-e0f5f145f2ae
                    meter_ids:
                    - beae2779-e392-4f00-b0cf-32e716204f78
                    - dd21c76c-7126-4ef7-b0a6-f190fad300b2
                    timeslots:
                    - market_group_event_id: 7ad4bbde-36ee-401f-92b8-c58aa17aa71d
                      start_time: 2023-07-21 18:00:00+00:00
                      end_time: 2023-07-21 22:00:00+00:00
                      energy_kw: 100
                      nomination_kw: 100
                      cancelled: false
                      programs:
                      - ERCOT-ERS
                      priority: 1
                      is_voluntary: false
                      performance_compensation_cap: up-to-nomination
                      dispatch_event_types:
                      - standard
              NYISO - SCR:
                value:
                  group_dispatches:
                  - market_group_id: 9d1a7aae-24e5-455f-91e9-e0f5f145f2ae
                    meter_ids:
                    - beae2779-e392-4f00-b0cf-32e716204f78
                    - dd21c76c-7126-4ef7-b0a6-f190fad300b2
                    timeslots:
                    - market_group_event_id: 8ad4bbde-36ee-401f-92b8-c58aa17aa71d
                      start_time: 2023-07-21 19:00:00+00:00
                      end_time: 2023-07-21 20:00:00+00:00
                      energy_kw: 100
                      nomination_kw: 100
                      cancelled: false
                      programs:
                      - NYISO-SCR
                      priority: 1
                      is_voluntary: false
                      performance_compensation_cap: up-to-nomination
                      dispatch_event_types:
                      - standard
              NYISO - CSRP:
                value:
                  group_dispatches:
                  - market_group_id: 9d1a7aae-24e5-455f-91e9-e0f5f145f2ae
                    meter_ids:
                    - beae2779-e392-4f00-b0cf-32e716204f78
                    - dd21c76c-7126-4ef7-b0a6-f190fad300b2
                    timeslots:
                    - market_group_event_id: 9ad4bbde-36ee-401f-92b8-c58aa17aa71d
                      start_time: 2023-07-21 16:00:00+00:00
                      end_time: 2023-07-21 20:00:00+00:00
                      energy_kw: 100
                      nomination_kw: 100
                      cancelled: false
                      programs:
                      - CONED-CSRP
                      priority: 3
                      is_voluntary: false
                      performance_compensation_cap: up-to-nomination
                      dispatch_event_types:
                      - standard
              NYISO - DLRP:
                value:
                  group_dispatches:
                  - market_group_id: 9d1a7aae-24e5-455f-91e9-e0f5f145f2ae
                    meter_ids:
                    - beae2779-e392-4f00-b0cf-32e716204f78
                    - dd21c76c-7126-4ef7-b0a6-f190fad300b2
                    timeslots:
                    - market_group_event_id: 10d4bbde-36ee-401f-92b8-c58aa17aa71d
                      start_time: 2023-07-21 14:00:00+00:00
                      end_time: 2023-07-21 18:00:00+00:00
                      energy_kw: 100
                      nomination_kw: 100
                      cancelled: false
                      programs:
                      - CONED-DLRP
                      priority: 5
                      is_voluntary: false
                      performance_compensation_cap: up-to-nomination
                      dispatch_event_types:
                      - standard
              ISO-NE - Clean Peak Standard:
                value:
                  group_dispatches:
                  - market_group_id: 9d1a7aae-24e5-455f-91e9-e0f5f145f2ae
                    meter_ids:
                    - beae2779-e392-4f00-b0cf-32e716204f78
                    - dd21c76c-7126-4ef7-b0a6-f190fad300b2
                    timeslots:
                    - market_group_event_id: 11d4bbde-36ee-401f-92b8-c58aa17aa71d
                      start_time: 2023-07-21 14:00:00+00:00
                      end_time: 2023-07-21 18:00:00+00:00
                      energy_kw: 100
                      nomination_kw: 100
                      cancelled: false
                      programs:
                      - MA_DOER-CPS
                      priority: 2
                      is_voluntary: true
                      performance_compensation_cap: grid-exports-allowed
                      dispatch_event_types:
                      - standard
              ISO-NE - Connected Solutions:
                value:
                  group_dispatches:
                  - market_group_id: 9d1a7aae-24e5-455f-91e9-e0f5f145f2ae
                    meter_ids:
                    - beae2779-e392-4f00-b0cf-32e716204f78
                    - dd21c76c-7126-4ef7-b0a6-f190fad300b2
                    timeslots:
                    - market_group_event_id: 12d4bbde-36ee-401f-92b8-c58aa17aa71d
                      start_time: 2023-07-21 15:00:00+00:00
                      end_time: 2023-07-21 18:00:00+00:00
                      energy_kw: 100
                      nomination_kw: 100
                      cancelled: false
                      programs:
                      - NATGRID-CS
                      priority: 1
                      is_voluntary: true
                      performance_compensation_cap: grid-exports-allowed
                      dispatch_event_types:
                      - standard
              PJM - Capacity:
                value:
                  group_dispatches:
                  - market_group_id: 9d1a7aae-24e5-455f-91e9-e0f5f145f2ae
                    meter_ids:
                    - beae2779-e392-4f00-b0cf-32e716204f78
                    - dd21c76c-7126-4ef7-b0a6-f190fad300b2
                    timeslots:
                    - market_group_event_id: 12d4bbde-36ee-401f-92b8-c58aa17aa71d
                      start_time: 2023-07-21 15:00:00+00:00
                      end_time: 2023-07-21 18:00:00+00:00
                      energy_kw: 100
                      nomination_kw: 100
                      cancelled: false
                      programs:
                      - PJM-CAPACITY
                      priority: 1
                      is_voluntary: false
                      performance_compensation_cap: up-to-nomination
                      dispatch_event_types:
                      - standard
            schema:
              $ref: '#/components/schemas/WebhookGroupDispatchIntegrationTestRequest'
        description: Test group dispatch notification
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookIntegrationTestResponse'
          description: 'Successfully triggered a test group notification to be sent to the registered group webhook url

            '
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Request could not be parsed or is invalid
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: No access to this resource
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Resource not found
        5XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unexpected error
      summary: Trigger test group notification
      tags:
      - group-dispatches
components:
  schemas:
    SearchGroupDispatchEventResponse:
      example:
        next_page_token: a946dfb9-5dc9-41f4-b9f2-4e5ac8fb5447
        results:
        - market_group_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91
          meter_ids:
          - a946dfb9-5dc9-41f4-b9f2-4e5ac8fb5447
          - 74a2444d-7b49-45d1-93f7-dd8c24b33130
          timeslots:
          - market_group_event_id: 904751e8-c0df-4d69-8a4f-9e7cebef1f84
            start_time: 2023-01-23 01:00:00+00:00
            end_time: 2023-01-23 02:00:00+00:00
            energy_kw: 95
            nomination_kw: 100
            cancelled: false
            programs:
            - CCA
            priority: 2
            is_voluntary: false
            performance_compensation_cap: up-to-site-load
            dispatch_event_types:
            - day-ahead
          - market_group_event_id: 3d1394e4-3f4a-4ee0-bd86-bf653ba29537
            start_time: 2023-01-23 02:00:00+00:00
            end_time: 2023-01-23 03:00:00+00:00
            energy_kw: 115
            nomination_kw: 120
            cancelled: false
            programs:
            - CCA
            priority: 2
            is_voluntary: false
            performance_compensation_cap: up-to-site-load
            dispatch_event_types:
            - day-ahead
            is_communication_test: false
      properties:
        next_page_token:
          description: 'Token to be used in a subsequent request to get the next batch of results. Max results per page is 500. Null when the last page of results has been reached

            '
          format: uuid
          type: string
        results:
          description: 'A list of market-group dispatches.

            '
          items:
            $ref: '#/components/schemas/SearchMarketGroupDispatchEvent'
          type: array
      required:
      - results
      type: object
    BaseSearchDispatchEventRequest:
      description: 'Search parameters for the search dispatches endpoints

        '
      properties:
        start_date:
          description: Start datetime range to get dispatches for (inclusive)
          format: date-time
          type: string
        end_date:
          description: 'End datetime range to get dispatches for (exclusive). End date must be max 31 days after the start date

            '
          format: date-time
          type: string
        exclude_real_time_events:
          default: true
          description: Exclude dispatches for CAISO 5 minute real time events in the response. If empty, 5 min real time events are excluded
          type: boolean
        exclude_voluntary_events:
          default: false
          description: Exclude dispatches for voluntary events in the response. If empty, all dispatches are returned
          type: boolean
        page_token:
          description: 'Token of the page to request. Max results per page is 500. Null to request a new batch of results

            '
          format: uuid
          type: string
      required:
      - end_date
      - start_date
      type: object
    WebhookIntegrationTestResponse:
      description: Dispatch notification successfully sent to webhook URL during an integration test
      example:
        sent_time: 2023-01-23 04:56:07+00:00
        headers:
          key:
          - x-api-key
          - your-key
        http_status: 200
        received_time: 2023-01-23 04:56:17+00:00
        body: body that is echoed
      properties:
        http_status:
          description: The http code from the response server for the webhook URL or 'null' if no response was received
          type: integer
        sent_time:
          description: Time when the request was sent
          format: date-time
          type: string
        received_time:
          description: Time when the response was received
          format: date-time
          type: string
        headers:
          additionalProperties:
            items:
              type: string
            type: array
          description: Http headers received from the server
          type: object
        body:
          description: 'Http body received from the server if present (so either a Meter Event Notification or  Market Group Event Notification), ''null'' otherwise

            '
          type: string
        error_message:
          description: In case the request to the webhook URL failed this field contains a description of the failure
          type: string
      required:
      - sent_time
      type: object
    BaseDispatchEventTimeslot:
      description: A single dispatch interval that describes all aspects of the dispatch.
      properties:
        start_time:
          description: Start time of dispatch
          example: 2021-09-14 22:00:00+00:00
          format: date-time
          type: string
        end_time:
          description: End time of dispatch
          example: 2021-09-14 23:00:00+00:00
          format: date-time
          type: string
        cancelled:
          description: '\''true'' if this event has been cancelled

            '
          type: boolean
        energy_kw:
          description: The awarded kW for the dispatch. This represents the expected power in kW to be curtailed/exported for the duration of the event. If the value is 'null' partners should dispatch the maximum they can manage.
          example: 115
          format: double
          maximum: 100000
          minimum: 0.01
          type: number
        nomination_kw:
          description: The nomination in kW. It represents the commitment amount made to the market for this asset.
          example: 115
          format: double
          maximum: 100000
          minimum: 0.01
          type: number
        performance_compensation_cap:
          $ref: '#/components/schemas/PerformanceCompensationCap'
        priority:
          description: 'The priority of the dispatch compared to other dispatches for the same meter. This value is meant to support partners in prioritizing dispatch events in same-day or overlapping scenarios, at times where the asset may not be able to perform across all events. Number 1 reflects the highest priority.

            '
          maximum: 10
          minimum: 1
          type: integer
        is_voluntary:
          description: 'Indicates whether the dispatch is voluntary or a commitment. Pay-for-performance events, with no energy commitment to achieve, are categorized as true. If a dispatch event constitutes a market or program commitment or carries partner penalties for non-performance, this is set to false.

            '
          type: boolean
        dispatch_event_types:
          description: 'Used for programs that have different compensation structures for different types of dispatch events. All programs with a single compensation structure for all events will be set to standard.

            '
          items:
            $ref: '#/components/schemas/DispatchEventType'
          minItems: 1
          type: array
          uniqueItems: true
        programs:
          description: 'Programs associated with the dispatch. This is a fixed list of values depending on your use-case and refers to the program(s) that the meters are enrolled in.

            '
          items:
            $ref: '#/components/schemas/program_identifier'
          minItems: 1
          type: array
          uniqueItems: true
      required:
      - cancelled
      - dispatch_event_types
      - end_time
      - is_voluntary
      - performance_compensation_cap
      - priority
      - programs
      - start_time
      type: object
    SearchGroupDispatchEventTimeslot:
      allOf:
      - properties:
          communication_test:
            description: Indicates whether the dispatch is a communication test.
            type: boolean
            x-field-extra-annotation: '@com.fasterxml.jackson.annotation.JsonIgnore'
        type: object
      - $ref: '#/components/schemas/GroupDispatchEventTimeslot'
      x-all-of-name: SearchGroupDispatchEventTimeslot
    WebhookMarketGroupDispatchEvent:
      description: 'Aggregates timeslot dispatches per market group. Previously stored dispatches might be updated so when dealing with a dispatch timeslot that has the same market_group_event_id as an existing one, the previously received dispatch has to be updated with the new field values.

        '
      properties:
        market_group_id:
          description: The id of the market group that received dispatches from the market.
          format: uuid
          type: string
        meter_ids:
          description: Ids of the meters that received dispatches from the market
          items:
            format: uuid
            type: string
          type: array
          uniqueItems: true
        partner_references:
          description: The partner-supplied reference IDs to help identify the customer or site that a Leap meter correlates to a partner’s internal systems.
          items:
            type: string
          type: array
          uniqueItems: true
        timeslots:
          description: List with timeslots and quantities that contains dispatches for this market group
          items:
            $ref: '#/components/schemas/GroupDispatchEventTimeslot'
          minItems: 1
          type: array
      required:
      - market_group_id
      - meter_ids
      - timeslots
      type: object
    PerformanceCompensationCap:
      description: 'This field can be used to automate a dispatch response that is aligned with the event’s settlement structure, to capitalize on scenarios where over-performance is lucrative versus scenarios where over-performance is not compensated and best reserved for another event.<br/> - UpToNomination - If partners dispatch beyond their nomination value, they will not be compensated.<br/> - UpToSiteLoad - Partners will be compensated for dispatching up to a site load of 0 kW.<br/> - GridExportsAllowed - Partners will be compensated for dispatching beyond a site load of 0 kW, into negative site load.

        '
      enum:
      - grid-exports-allowed
      - up-to-nomination
      - up-to-site-load
      type: string
      x-enum-varnames:
      - GRID_EXPORTS_ALLOWED
      - UP_TO_NOMINATION
      - UP_TO_SITE_LOAD
    SearchMarketGroupDispatchEvent:
      description: 'Aggregates timeslot dispatches per market group. Previously stored dispatches might be updated so when dealing with a dispatch timeslot that has the same market_group_event_id as an existing one, the previously received dispatch has to be updated with the new field values.

        '
      properties:
        market_group_id:
          description: The id of the market group that received dispatches from the market.
          format: uuid
          type: string
        meter_ids:
          description: Ids of the meters that received dispatches from the market
          items:
            format: uuid
            type: string
          type: array
          uniqueItems: true
        partner_references:
          description: The partner-supplied reference IDs to help identify the customer or site that a Leap meter correlates to a partner’s internal systems.
          items:
            type: string
          type: array
          uniqueItems: true
        timeslots:
          description: List with timeslots and quantities that contains dispatches for this market group
          items:
            $ref: '#/components/schemas/SearchGroupDispatchEventTimeslot'
          minItems: 1
          type: array
      required:
      - market_group_id
      - meter_ids
      - timeslots
      type: object
    GroupDispatchEventTimeslot:
      allOf:
      - properties:
          market_group_event_id:
            description: Unique identifier of the market group dispatch event
            format: uuid
            type: string
        type: object
      - $ref: '#/components/schemas/BaseDispatchEventTimeslot'
      required:
      - market_group_event_id
      x-all-of-name: GroupDispatchEventTimeslot
    SearchGroupDispatchEventRequest:
      allOf:
      - properties:
          market_group_ids:
            description: Market group ids to get group dispatches for
            items:
              format: uuid
              type: string
            minItems: 1
            type: array
            uniqueItems: true
          market_group_event_ids:
            description: Market group event ids to get group disp

# --- truncated at 32 KB (37 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/leap/refs/heads/main/openapi/leap-group-dispatches-api-openapi.yml