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

# Get Simplified Tariff

> Get a simplified, indicative view of a [Tariff](/api-reference/cost-of-energy/models/tariff)'s rates over a time range.

The response is a set of rate timeseries, one per (input dataset, rate unit). In each interval, `rate` is what is paid per kWh of energy on the input (for per-kWh series) or per kW of power peak derived from the input (for per-kW series), in the series' own currency.

This is an approximation of the tariff's price shape, meant for heuristics that need a coarse "when is energy cheap/expensive" signal — not for exact cost calculation or optimisation.

Components that don't fit a simple per-kWh or per-kW rate (fixed fees, spot-price-linked charges, overdraft fees …) are surfaced by name and applicability window in `unprojectable_components` rather than appearing in the rate timeseries.

Use [Calculate Tariff](/api-reference/calculate-tariff) for exact cost calculation, or [In Optimisation](/api-reference/cost-of-energy/optimisation) for using tariffs in optimisation models.



## OpenAPI

````yaml GET /cost-of-energy/v1/tariffs/{tariff_id}/simplified
openapi: 3.1.0
info:
  title: Engrate API
  version: 1.0.0
servers:
  - url: https://api.engrate.io
security:
  - apiKeyAuth: []
paths:
  /cost-of-energy/v1/tariffs/{tariff_id}/simplified:
    get:
      summary: Get Simplified Tariff
      description: >-
        Get a simplified, indicative view of a
        [Tariff](/api-reference/cost-of-energy/models/tariff)'s rates over a
        time range.


        The response is a set of rate timeseries, one per (input dataset, rate
        unit). In each interval, `rate` is what is paid per kWh of energy on the
        input (for per-kWh series) or per kW of power peak derived from the
        input (for per-kW series), in the series' own currency.


        This is an approximation of the tariff's price shape, meant for
        heuristics that need a coarse "when is energy cheap/expensive" signal —
        not for exact cost calculation or optimisation.


        Components that don't fit a simple per-kWh or per-kW rate (fixed fees,
        spot-price-linked charges, overdraft fees …) are surfaced by name and
        applicability window in `unprojectable_components` rather than appearing
        in the rate timeseries.


        Use [Calculate Tariff](/api-reference/calculate-tariff) for exact cost
        calculation, or [In
        Optimisation](/api-reference/cost-of-energy/optimisation) for using
        tariffs in optimisation models.
      operationId: >-
        get_simplified_tariff_cost_of_energy_v1_tariffs__tariff_id__simplified_get
      parameters:
        - in: path
          name: tariff_id
          required: true
          schema:
            format: uuid
            title: Tariff Id
            type: string
        - description: >-
            ISO 8601 timezone-aware datetime at which the range begins
            (inclusive).
          in: query
          name: start_time
          required: true
          schema:
            description: >-
              ISO 8601 timezone-aware datetime at which the range begins
              (inclusive).
            format: date-time
            title: Start Time
            type: string
        - description: >-
            ISO 8601 timezone-aware datetime at which the range ends
            (exclusive). Must be strictly greater than `start_time`.
          in: query
          name: end_time
          required: true
          schema:
            description: >-
              ISO 8601 timezone-aware datetime at which the range ends
              (exclusive). Must be strictly greater than `start_time`.
            format: date-time
            title: End Time
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SimplifiedTariffResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
components:
  schemas:
    SimplifiedTariffResponse:
      description: >-
        Indicative, simplified view of a
        [Tariff](/api-reference/cost-of-energy/models/tariff)'s rates over a
        time range.
      example:
        component_rates:
          - component:
              applicable_from: '2026-01-01T00:00:00+01:00'
              name: Energiskatt
            rate:
              dataset_id: quarter-hourly-energy-offtake
              intervals:
                - end_time: '2026-01-02T00:00:00Z'
                  rate: 0.36
                  start_time: '2026-01-01T00:00:00Z'
              unit: SEK_per_kWh
          - component:
              applicable_from: '2026-01-01T00:00:00+01:00'
              name: Effektavgift
            rate:
              dataset_id: quarter-hourly-energy-offtake
              intervals:
                - end_time: '2026-01-01T06:00:00Z'
                  rate: 0
                  start_time: '2026-01-01T00:00:00Z'
                - end_time: '2026-01-01T22:00:00Z'
                  rate: 50
                  start_time: '2026-01-01T06:00:00Z'
                - end_time: '2026-01-02T00:00:00Z'
                  rate: 0
                  start_time: '2026-01-01T22:00:00Z'
              unit: SEK_per_kW
        dataset_rates:
          - dataset_id: quarter-hourly-energy-offtake
            intervals:
              - end_time: '2026-01-02T00:00:00Z'
                rate: 0.56
                start_time: '2026-01-01T00:00:00Z'
            unit: SEK_per_kWh
          - dataset_id: quarter-hourly-energy-offtake
            intervals:
              - end_time: '2026-01-01T06:00:00Z'
                rate: 0
                start_time: '2026-01-01T00:00:00Z'
              - end_time: '2026-01-01T22:00:00Z'
                rate: 50
                start_time: '2026-01-01T06:00:00Z'
              - end_time: '2026-01-02T00:00:00Z'
                rate: 0
                start_time: '2026-01-01T22:00:00Z'
            unit: SEK_per_kW
        unprojectable_components:
          - applicable_from: '2026-01-01T00:00:00+01:00'
            name: Abonnemangsavgift
      properties:
        component_rates:
          description: >-
            Per-component rate timeseries, for components that can be projected
            onto a per-kWh or per-kW rate. Empty if the tariff has no
            projectable components.
          items:
            $ref: '#/components/schemas/ComponentRate'
          title: Component Rates
          type: array
        dataset_rates:
          description: >-
            Summed rate timeseries per `(dataset_id, unit)` group, across all
            projectable components contributing to that group. Empty if the
            tariff has no projectable components.
          items:
            $ref: '#/components/schemas/RateTimeseries'
          title: Dataset Rates
          type: array
        unprojectable_components:
          description: >-
            Tariff components present on the tariff that could not be projected
            onto a rate timeseries. Listed by name and applicability window
            only; see [Get Tariff](/api-reference/cost-of-energy/get-tariff) for
            full component definitions.
          items:
            $ref: '#/components/schemas/ComponentIdentity'
          title: Unprojectable Components
          type: array
      required:
        - component_rates
        - dataset_rates
        - unprojectable_components
      title: SimplifiedTariffResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ComponentRate:
      description: A single tariff component's projected rate timeseries.
      example:
        component:
          applicable_from: '2026-01-01T00:00:00+01:00'
          name: Energiskatt
        rate:
          dataset_id: quarter-hourly-energy-offtake
          intervals:
            - end_time: '2027-01-01T00:00:00Z'
              rate: 0.36
              start_time: '2026-01-01T00:00:00Z'
          unit: SEK_per_kWh
      properties:
        component:
          $ref: '#/components/schemas/ComponentIdentity'
          description: Identifying fields of the component this rate timeseries belongs to.
        rate:
          $ref: '#/components/schemas/RateTimeseries'
          description: The component's projected rate timeseries.
      required:
        - component
        - rate
      title: ComponentRate
      type: object
    RateTimeseries:
      description: >-
        A single rate timeseries for one input dataset and unit, made up of
        chronologically ordered, non-overlapping flat-rate Rate Intervals.
      example:
        dataset_id: quarter-hourly-energy-offtake
        intervals:
          - end_time: '2026-01-01T06:00:00Z'
            rate: 0
            start_time: '2026-01-01T00:00:00Z'
          - end_time: '2026-01-01T22:00:00Z'
            rate: 50
            start_time: '2026-01-01T06:00:00Z'
          - end_time: '2026-01-02T00:00:00Z'
            rate: 0
            start_time: '2026-01-01T22:00:00Z'
        unit: SEK_per_kW
      properties:
        dataset_id:
          description: >-
            Identifier of the
            [Dataset](/api-reference/cost-of-energy/models/dataset) this
            timeseries' rates apply to.
          examples:
            - quarter-hourly-energy-offtake
            - quarter-hourly-energy-injection
          title: Dataset Id
          type: string
        intervals:
          description: >-
            Chronologically ordered, non-overlapping flat-rate intervals
            covering the requested range exactly.
          items:
            $ref: '#/components/schemas/RateInterval'
          title: Intervals
          type: array
        unit:
          anyOf:
            - enum:
                - SEK_per_kWh
                - NOK_per_kWh
                - EUR_per_kWh
              type: string
            - enum:
                - SEK_per_kW
                - NOK_per_kW
                - EUR_per_kW
              type: string
          description: >-
            Unit of the rates in this timeseries — a monetary rate per energy
            (`SEK_per_kWh`, `NOK_per_kWh`, `EUR_per_kWh`) or per power
            (`SEK_per_kW`, `NOK_per_kW`, `EUR_per_kW`).
          title: Unit
      required:
        - dataset_id
        - intervals
        - unit
      title: RateTimeseries
      type: object
    ComponentIdentity:
      description: >-
        Identifies a tariff component by its issuing-party name and
        applicability window. See [Tariff
        Component](/api-reference/cost-of-energy/models/tariff-component) for
        the full definition.
      example:
        applicable_from: '2026-01-01T00:00:00+01:00'
        name: Energiskatt
      properties:
        applicable_from:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: >-
            ISO 8601 formatted datetime from when the tariff component becomes
            applicable, if any. If `null` or not included, applicable
            immediately.
          examples:
            - '2026-01-01T00:00:00+01:00'
          title: Applicable From
        applicable_to:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: >-
            ISO 8601 formatted datetime at which the tariff component ceases to
            be applicable (exclusive — the component does not apply at this
            instant). If `null` or not included, applicable until further
            notice.
          examples:
            - '2027-01-01T00:00:00+01:00'
          title: Applicable To
        name:
          description: >-
            Name of the tariff component as given by the issuing
            [Party](/api-reference/core/models/party).
          examples:
            - Energiskatt
            - Överföringsavgift
            - Effektavgift
            - Abonnemangsavgift
            - Nätnytta
            - Överuttagsavgift
          title: Name
          type: string
      required:
        - name
      title: ComponentIdentity
      type: object
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
    RateInterval:
      description: >-
        A flat-rate slice of a Rate Timeseries, spanning the half-open UTC range
        `[start_time, end_time)`.
      example:
        end_time: '2026-01-01T22:00:00Z'
        rate: 50
        start_time: '2026-01-01T06:00:00Z'
      properties:
        end_time:
          description: >-
            ISO 8601 formatted UTC datetime at which this interval ends
            (exclusive).
          examples:
            - '2026-01-01T22:00:00Z'
          format: date-time
          title: End Time
          type: string
        rate:
          description: >-
            Flat rate that applies across this interval, expressed in the parent
            timeseries' unit.
          title: Rate
          type: number
        start_time:
          description: >-
            ISO 8601 formatted UTC datetime at which this interval begins
            (inclusive).
          examples:
            - '2026-01-01T06:00:00Z'
          format: date-time
          title: Start Time
          type: string
      required:
        - end_time
        - rate
        - start_time
      title: RateInterval
      type: object
  securitySchemes:
    apiKeyAuth:
      in: header
      name: Authorization
      type: apiKey

````