API Access¶

The Wattnet API lets you query carbon and water footprint data programmatically. Access is currently granted on request. Once you have been granted access, you can register and generate a Bearer token for development and testing purposes.

Requesting access¶

To request access to the API, get in touch through wattnet.eu/contact. Once access has been granted, you can register and generate a Bearer token as described below.

Use of the API is subject to the Wattnet terms.

Token service¶

The token service is available at https://api.wattnet.eu/token-request/. You can also interact with it directly through the browser at that URL.

1. Register¶

This step only needs to be done once; after that, you can go straight to obtaining a token with the same credentials.

curl -X POST "https://api.wattnet.eu/token-request/register" \
  -H "Content-Type: application/json" \
  -d '{ "email": "your_email", "password": "your_password" }'

2. Obtain a token¶

Tokens are valid for 1 day and can be refreshed using the same credentials:

curl -X POST "https://api.wattnet.eu/token-request/get_token" \
  -H "Content-Type: application/json" \
  -d '{ "email": "your_email", "password": "your_password" }'

3. Query the API¶

curl -X GET "https://api.wattnet.eu/v1/footprints?footprint_type=carbon…" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your_token>"

Results include data quality flags (zone_status and valid); see the API Data Model for how to interpret them.

Common errors¶

• 401 Unauthorized when querying the API: your Bearer token is missing, malformed, or has expired. Tokens are valid for 1 day; repeat step 2 to get a fresh one.
• 401 Unauthorized when obtaining a token: the email/password combination is incorrect, or you have not registered yet. See step 1.
• Registration fails: make sure you have been granted access first; registering an email that hasn't been approved will not work.

Managing your account¶

Resetting your password¶

To reset a forgotten or compromised password, get in touch through wattnet.eu/contact.

Getting support¶

For any other account issues, such as trouble registering, obtaining a token, or requesting access, get in touch through wattnet.eu/contact.