> ## Documentation Index
> Fetch the complete documentation index at: https://podpora.cubee.cz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get HDO command schedule

> The VT/NT switching schedule one HDO command follows, as time ranges per day type.



## OpenAPI

````yaml /api-reference/swagger-partner.json get /api/v1/reference/distributors/{distributor}/commands/{command}/periods
openapi: 3.0.4
info:
  title: Partner API
  description: API for partner services
  version: v1
servers:
  - url: https://api.partner.cubee.cz
    description: Partnerý API server
security: []
tags:
  - name: Aggregated Data
  - name: Authentication
  - name: Calculator
  - name: CalculatorControllerV1
  - name: InvoiceExtraction
  - name: Public
  - name: Reference data
  - name: Studies
paths:
  /api/v1/reference/distributors/{distributor}/commands/{command}/periods:
    get:
      tags:
        - Reference data
      summary: Get HDO command schedule
      description: >-
        The VT/NT switching schedule one HDO command follows, as time ranges per
        day type.
      operationId: Get HDO command schedule
      parameters:
        - name: distributor
          in: path
          description: Distributor code — CEZ, PRE or EGD.
          required: true
          schema:
            type: string
        - name: command
          in: path
          description: The HDO command whose VT/NT switching schedule to return.
          required: true
          schema:
            type: string
        - name: regionKey
          in: query
          description: Optional HDO region key to disambiguate a region-specific command.
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/DistributorTariffDetailModel'
              example:
                - id: f6b8d0e2-6a7c-4d1e-3f4a-5b6c7d8e9f0a
                  distributorKey: CEZ
                  distributorName: ČEZ Distribuce
                  regionTypeId: null
                  regionTypeKey: null
                  regionTypeName: null
                  code: A1B4DP6
                  command: EVV2
                  validFrom: '2025-01-01'
                  validTo: null
                  tariffSchedules:
                    - dayTypeKey: WORKDAY
                      sortIndex: 1
                      timeRanges:
                        - periodStart: '00:00:00'
                          periodEnd: '06:00:00'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/ProblemDetails'
                  - $ref: '#/components/schemas/HttpValidationProblemDetails'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/ProblemDetails'
                  - $ref: '#/components/schemas/HttpValidationProblemDetails'
        '500':
          description: Internal Server Error
      security:
        - {}
components:
  schemas:
    DistributorTariffDetailModel:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier of the tariff detail.
          format: uuid
          example: f6b8d0e2-6a7c-4d1e-3f4a-5b6c7d8e9f0a
        distributorKey:
          type: string
          description: Distributor this schedule belongs to (CEZ / PRE / EGD).
          nullable: true
          example: CEZ
        distributorName:
          type: string
          description: Display name of the distributor.
          nullable: true
          example: ČEZ Distribuce
        regionTypeId:
          type: string
          description: >-
            Internal identifier of the HDO region, when region-specific;
            otherwise null.
          format: uuid
          nullable: true
        regionTypeKey:
          type: string
          description: Key of the HDO region, when region-specific; otherwise null.
          nullable: true
        regionTypeName:
          type: string
          description: Display name of the HDO region, when region-specific.
          nullable: true
        code:
          type: string
          description: >-
            Short HDO command code — the alternate identifier some price lists
            use for the command.

            The command-schedule lookup accepts either this `Code` or `Command`.
          nullable: true
          example: A1B4DP6
        command:
          type: string
          description: The HDO command that switches the low tariff (e.g. "A1B4DP6").
          nullable: true
          example: EVV2
        validFrom:
          type: string
          description: Date from which this schedule is valid.
          format: date
          example: '2025-01-01'
        validTo:
          type: string
          description: Date until which this schedule is valid, when bounded.
          format: date
          nullable: true
        tariffSchedules:
          type: array
          items:
            $ref: '#/components/schemas/HouseholdLowTariffModel'
          description: The low-tariff (NT) switching windows, grouped by day type.
          nullable: true
          example:
            - dayTypeKey: WORKDAY
              sortIndex: 1
              timeRanges:
                - periodStart: '00:00:00'
                  periodEnd: '06:00:00'
      additionalProperties: false
      description: >-
        An HDO command and the low-tariff (NT) switching schedule it drives, for
        a distributor.
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
      additionalProperties: {}
    HttpValidationProblemDetails:
      allOf:
        - $ref: '#/components/schemas/ProblemDetails'
        - type: object
          properties:
            errors:
              type: object
              additionalProperties:
                type: array
                items:
                  type: string
              nullable: true
          additionalProperties: {}
    HouseholdLowTariffModel:
      type: object
      properties:
        dayTypeKey:
          type: string
          description: Day type the windows apply to (e.g. "WORKDAY", "WEEKEND").
          nullable: true
          example: WORKDAY
        sortIndex:
          type: integer
          description: Ordering index of the day type.
          format: int32
          nullable: true
          example: 1
        timeRanges:
          type: array
          items:
            oneOf:
              - $ref: '#/components/schemas/TimeRangeModel'
              - $ref: '#/components/schemas/TimeRangeExtendedModel'
            description: A time-of-day window (local time).
          description: The time windows within the day when the low tariff (NT) applies.
          nullable: true
          example:
            - periodStart: '00:00:00'
              periodEnd: '06:00:00'
      additionalProperties: false
      description: The low-tariff (NT) time windows for a single day type.
    TimeRangeModel:
      type: object
      properties:
        periodStart:
          type: string
          description: Start time of the window (local time).
          format: time
          example: '00:00:00'
        periodEnd:
          type: string
          description: End time of the window (local time).
          format: time
          example: '06:00:00'
      additionalProperties: false
      description: A time-of-day window (local time).
    TimeRangeExtendedModel:
      allOf:
        - $ref: '#/components/schemas/TimeRangeModel'
        - type: object
          properties:
            isLowTariff:
              type: boolean
            duration:
              type: string
              format: date-span
              readOnly: true
          additionalProperties: false

````