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

# Eco Surcharges

> Surcharges (Aufschläge) of optional ecological electricity products
(wassertop, ökopower, suntop, …) vs the DSO's cheapest standard product
of the same voltage level, in Rp/kWh.



## OpenAPI

````yaml /openapi.json get /api/v1/dsos/{dso_id}/eco-surcharges
openapi: 3.1.0
info:
  title: n:lead Swiss Tariffs
  description: >
    Electricity tariffs for every Swiss distribution grid operator, harmonized
    from

    the operators' own publications and ElCom's open data.


    Documentation and guides: https://docs.tariffs.nlead.ch


    Free, no key, no registration. Reads are open to any origin, every answer

    carries an `ETag` and a `Cache-Control`, and a rate limit of 120 requests a

    minute per address keeps one runaway script from spoiling it for everyone.


    Every tariff says where its figures came from. Values a reviewer has
    confirmed

    against the operator's own document and values a model read out of a PDF are

    both published, and always distinguishable — see the *Provenance* page.
  version: '1'
servers:
  - url: https://ch-el-tarif-db.azurewebsites.net
    description: production
security: []
tags:
  - name: find a tariff
    description: >-
      Start from an operator or from what a tariff is, and get one answer with
      its provenance.
  - name: dataset
    description: >-
      The harmonized dataset: tariffs, feed-in, national charges, time series
      and bulk export.
  - name: map and app data
    description: >-
      What the public map itself draws — areas, coverage, medians and collection
      status.
paths:
  /api/v1/dsos/{dso_id}/eco-surcharges:
    get:
      tags:
        - dataset
      summary: Eco Surcharges
      description: |-
        Surcharges (Aufschläge) of optional ecological electricity products
        (wassertop, ökopower, suntop, …) vs the DSO's cheapest standard product
        of the same voltage level, in Rp/kWh.
      operationId: eco_surcharges_api_v1_dsos__dso_id__eco_surcharges_get
      parameters:
        - name: dso_id
          in: path
          required: true
          schema:
            type: string
            title: Dso Id
        - name: period
          in: query
          required: false
          schema:
            type: integer
            default: 2026
            title: Period
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.