Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: evcc Tariffs API
description: smart charging. open source energy management.
version: 0.2.0
contact:
url: https://github.com/evcc-io/evcc
servers:
- url: https://demo.evcc.io/api
tags:
- name: tariffs
paths:
/tariff/{type}:
get:
operationId: getTariffInfo
summary: Tariff information
description: Returns the prices or emission values for the upcoming hours
externalDocs:
url: https://docs.evcc.io/en/tariffs
tags:
- tariffs
parameters:
- name: type
in: path
description: Tariff type
required: true
schema:
type: string
enum:
- grid
- feedin
- co2
- planner
- solar
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
rates:
$ref: '#/components/schemas/Rates'
'404':
description: Tariff not defined
components:
schemas:
Rates:
type: array
items:
$ref: '#/components/schemas/Rate'
Rate:
description: A time slot with an associated price or emission value.
type: object
properties:
start:
description: Start of the time slot.
type: string
format: date-time
end:
description: End of the time slot.
type: string
format: date-time
value:
description: Price per kWh in the configured currency or emissions in g/kWh.
type: number
required:
- start
- end
- value
securitySchemes:
cookieAuth:
type: apiKey
in: cookie
name: auth
bearerAuth:
type: http
scheme: bearer
description: 'Long-lived API key (prefixed `evcc_`, managed via /auth/apikey).
Grants access to /api/db/* without requiring the X-Admin-Password header.
'