> ## 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 consumption profile

> Distributes a yearly consumption over the 12 calendar months by a TDD class's seasonal shape — the
same load profile the calculator models with, summed per month. Returns 12 items whose values add up
to exactly the input; use it to draw the consumption graph in a wizard. The `tdd` value comes
from `GET /api/v1/reference/distribution-rates`.



## OpenAPI

````yaml /api-reference/swagger-partner.json get /api/v1/reference/consumption-profile
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/consumption-profile:
    get:
      tags:
        - Reference data
      summary: Get consumption profile
      description: >-
        Distributes a yearly consumption over the 12 calendar months by a TDD
        class's seasonal shape — the

        same load profile the calculator models with, summed per month. Returns
        12 items whose values add up

        to exactly the input; use it to draw the consumption graph in a wizard.
        The `tdd` value comes

        from `GET /api/v1/reference/distribution-rates`.
      operationId: Get consumption profile
      parameters:
        - name: tdd
          in: query
          description: TDD load-profile class, "TDD1"–"TDD8" (a bare "1"–"8" also works).
          schema:
            type: string
        - name: yearlyConsumptionKWh
          in: query
          description: Total yearly consumption to distribute, in kWh. Must be positive.
          schema:
            type: number
            format: double
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MonthlyConsumption'
              example:
                - month: 1
                  consumptionKWh: 424.53
                - month: 2
                  consumptionKWh: 388.2
                - month: 3
                  consumptionKWh: 372.41
                - month: 4
                  consumptionKWh: 321.72
                - month: 5
                  consumptionKWh: 291.16
                - month: 6
                  consumptionKWh: 264.86
                - month: 7
                  consumptionKWh: 259.33
                - month: 8
                  consumptionKWh: 262.35
                - month: 9
                  consumptionKWh: 288.11
                - month: 10
                  consumptionKWh: 334.14
                - month: 11
                  consumptionKWh: 380.29
                - month: 12
                  consumptionKWh: 412.9
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/ProblemDetails'
                  - $ref: '#/components/schemas/HttpValidationProblemDetails'
        '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:
    MonthlyConsumption:
      type: object
      properties:
        month:
          type: integer
          description: Calendar month, 1 (January) – 12 (December).
          format: int32
          example: 1
        consumptionKWh:
          type: number
          description: Consumption modelled for that month, in kWh.
          format: double
          example: 424.53
      additionalProperties: false
      description: One month of a TDD-shaped yearly consumption.
    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: {}

````