# Corrently.io API

> Corrently.io API on Apizie: 26 endpoints (Returns lastSession info for all easee wallboxes (chargers) given user has access to., Last Session Info, Public shared smart meters installed in Germany and available for subservices and exploration., Public shared smart meters installed in Germany and available for subservices and exploration., …) returned as clean JSON through one API key. 26 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/open-data:corrently/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:corrently`
- Category: Open Data
- Status: live
- Source: https://stromdao.de/kontakt
- Page: https://zieapi.vercel.app/api/open-data/corrently
- OpenAPI: https://zieapi.vercel.app/api/open-data/corrently/openapi.json

*Corrently - from italian corrente, which is energy* # Introduction The Corrently ecosystem gets maintained by [STROMDAO GmbH](https://www.stromdao.de/) to support green energy services for prosumers, grid operators,…

## Endpoints

### Returns lastSession info for all easee wallboxes (chargers) given user has access to.
`GET https://zieapi.vercel.app/v1/open-data:corrently/easee-sessions`

| Parameter | Type | Required | Description |
|---|---|---|---|
| username | string | no | Username as used on easy.cloud |
| password | string | no | Password as used on easy.cloud |

### Last Session Info
`GET https://zieapi.vercel.app/v1/open-data:corrently/ocpp-sessions`

### Public shared smart meters installed in Germany and available for subservices and exploration.
`GET https://zieapi.vercel.app/v1/open-data:corrently/om-activities`

### Public shared smart meters installed in Germany and available for subservices and exploration.
`GET https://zieapi.vercel.app/v1/open-data:corrently/om-meters`

### Public shared smart meters installed in Germany and available for subservices and exploration.
`GET https://zieapi.vercel.app/v1/open-data:corrently/om-readings`

### Get best hour (with most regional green energy) in a given timeframe.
`GET https://zieapi.vercel.app/v1/open-data:corrently/gsi-besthour`

| Parameter | Type | Required | Description |
|---|---|---|---|
| zip | string | no | Zipcode (Postleitzahl) of a city in Germany. |
| key | string | no | Any valid Stromkonto account (address). |
| timeframe | integer | no | Number of hours to check (default 24 hours from now). |
| hours | integer | no | How many hours in row do you need the device turned on? |

### Dispatch (Green Energy Distribution Schedule)
`GET https://zieapi.vercel.app/v1/open-data:corrently/gsi-dispatch`

| Parameter | Type | Required | Description |
|---|---|---|---|
| zip | string | no | Zipcode (Postleitzahl) of a city in Germany. |
| key | string | no | Any valid Stromkonto account (address). |

### Marketdata
`GET https://zieapi.vercel.app/v1/open-data:corrently/gsi-marketdata`

| Parameter | Type | Required | Description |
|---|---|---|---|
| zip | string | no | Zipcode (Postleitzahl) of a city in Germany. |

### Prediction
`GET https://zieapi.vercel.app/v1/open-data:corrently/gsi-prediction`

| Parameter | Type | Required | Description |
|---|---|---|---|
| zip | string | no | Zipcode (Postleitzahl) of a city in Germany. |
| key | string | no | Any valid Stromkonto account (address). |

### Meter Reading
`GET https://zieapi.vercel.app/v1/open-data:corrently/metering-get`

| Parameter | Type | Required | Description |
|---|---|---|---|
| account | string | no | Account/Address (Stromkonto) to retrieve reading for. |

### Meter Reading
`POST https://zieapi.vercel.app/v1/open-data:corrently/metering-post`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Finishs a collection of data and finalizes receipt. Use this method after collecting all data via…
`POST https://zieapi.vercel.app/v1/open-data:corrently/quittung-comit`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Create a receipt for an energy delivery (only valid in Germany).
`POST https://zieapi.vercel.app/v1/open-data:corrently/quittung-create`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Allows to collect data with several requests (or a single) for a receipt.
`POST https://zieapi.vercel.app/v1/open-data:corrently/quittung-prepare`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Retrieve TSE (Technische Sicherheitseinrichtung) Data for a given receipt (Strom-Quittung).
`POST https://zieapi.vercel.app/v1/open-data:corrently/quittung-tse`

| Parameter | Type | Required | Description |
|---|---|---|---|
| account | string | no | Quittung Identifier (serialnumber generated during receipt generation process) |

### Retrieve TSE (Technische Sicherheitseinrichtung) raw data only for a given receipt (Strom-Quittung).
`POST https://zieapi.vercel.app/v1/open-data:corrently/quittung-tsedata`

| Parameter | Type | Required | Description |
|---|---|---|---|
| account | string | no | Quittung Identifier (serialnumber generated during receipt generation process) |

### Retrieve TSE (Technische Sicherheitseinrichtung) Signature only for a given receipt (Strom-Quittung).
`POST https://zieapi.vercel.app/v1/open-data:corrently/quittung-tsesignature`

| Parameter | Type | Required | Description |
|---|---|---|---|
| account | string | no | Quittung Identifier (serialnumber generated during receipt generation process) |

### Retrieve Zugferd XML for a given receipt (Strom-Quittung).
`GET https://zieapi.vercel.app/v1/open-data:corrently/quittung-zugferd`

| Parameter | Type | Required | Description |
|---|---|---|---|
| account | string | no | Quittung Identifier (serialnumber generated during receipt generation process) |

### Balances
`GET https://zieapi.vercel.app/v1/open-data:corrently/stromkonto-balances`

| Parameter | Type | Required | Description |
|---|---|---|---|
| account | string | no | Ethereum style address referencing a valid account (AKA Stromkonto). |

### Selectable Choices for customer
`GET https://zieapi.vercel.app/v1/open-data:corrently/stromkonto-choices`

| Parameter | Type | Required | Description |
|---|---|---|---|
| account | string | no | Ethereum style address referencing a valid account alias (never use Stromkonto directly!). |

### Login (via Mail)
`POST https://zieapi.vercel.app/v1/open-data:corrently/stromkonto-login`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Prepare Transaction
`POST https://zieapi.vercel.app/v1/open-data:corrently/prepare-transaction`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Register (new Stromkonto)
`POST https://zieapi.vercel.app/v1/open-data:corrently/stromkonto-register`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Energy Tariff price components
`GET https://zieapi.vercel.app/v1/open-data:corrently/tariffcomponents`

| Parameter | Type | Required | Description |
|---|---|---|---|
| zipcode | string | no | Zipcode (Postzleitzahl) of a city in Germany. |
| email | string | no | Valid email address to assign request to (pre offer generation). Ensure GDPR (DSGVO) at any time |
| kwha | integer | no | Total amount of energy in kilo-watt-hours per year. (sample 2100) |
| milliseconds | integer | no | If provided all results will be scaled to this timeframe |
| wh | integer | no | If provided together with milliseconds, a cost component stament for a particular event (like charging a car) will be created. |

### Energy Tariff information
`GET https://zieapi.vercel.app/v1/open-data:corrently/tariff-slph0`

| Parameter | Type | Required | Description |
|---|---|---|---|
| zipcode | string | no | Zipcode (Postzleitzahl) of a city in Germany. |

### WiM Proess Informtion
`GET https://zieapi.vercel.app/v1/open-data:corrently/wimstatus`

| Parameter | Type | Required | Description |
|---|---|---|---|
| vid | string | no | VID key of the process. |

## Example
```
curl "https://zieapi.vercel.app/v1/open-data:corrently/easee-sessions" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Corrently.io API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/open-data:corrently/easee-sessions with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Corrently.io API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the Corrently.io API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key open-data:corrently.

### What is the status of the Corrently.io API?
Live: works with just an Apizie key