---
updatedAt: 2025-11-05T21:22:51.000Z
agentTools:
  projectIndex: https://developers.modoenergy.com/llms.txt
---

# Authorisation

How does our API authorisation works

# How does the authorisation work

We use an API token as a header (called an x-token), which you can find under your Modo Energy account on the [platform](https://modoenergy.com/profile/developers).

Use your token as a header.

> X-Token: \<token\_from\_account>

Here is an example of how it should look:

```c curl
curl -
-location 'https://api.modo.energy/public/v1/frequency?date_from=2023-03-07&date_to=2023-03-07&limit=1000&offset=3000' \
--header 'X-Token: <token_from_account>'
```

> 🚧 Keep your token secret
>
> This token is a secret. To keep your integration secure, never store the token in your source code or commit it in version control. Instead, read the the token from an environment variable. Use a secret manager or deployment system to set the token in the environment.