Overview
A sandbox API key lets you explore and prototype against the Electricity Maps API using sample data.
The sandbox is designed for safe experimentation, not production use.
Explore endpoints and prototype freely with sample data (±30% randomization).
Use it to validate structure, not data quality.
What a sandbox key is (and isn’t)
A sandbox key:
Works with real API endpoints
Returns realistic-looking data with ±30% randomization
Is safe to use for prototypes, demos, and proofs of concept
A sandbox key is not:
Real electricity data
Suitable for analysis, reporting, or decision-making
A replacement for production access
How to generate a sandbox key
You can generate a sandbox key in two ways:
From the API Playground
Open the Playground
Activate or select the sandbox key
Copy the key for use
From your account settings
Go to your settings
Generate a sandbox API key
Copy it for use in your requests
Where you can use a sandbox key
A sandbox key can be used:
Directly in the API Playground
In your own code, calling the API endpoints
In local or staging environments
This allows you to build integrations that will later work with production data by only switching the API key.
Moving from sandbox to real data
When you’re ready to work with real data you can just request a trial:
Review supported zones and signals
Choose the right access type
Request production access or pricing as needed
Related articles
Understanding and using our API → Full endpoint documentation and examples
Using the API Playground → Interactive testing without code
Pricing and quotes → Production access and licensing