Carbon Aware Scheduling API

Up to date data

Grid data is updated between every 5 minutes and every hour

Multiple Query Types

Lookup airport codes, data center region ids, countries or zones.

Listings of the best options

The API returns a list of best places to schedule your workload

Scheduling Query Types

The API can be queried for lots of use cases

Best Region Rank

Query for the lowest carbon regions across the world to schedule your workloads

This first sorts all regions by CO2, then by Spot Availability and then Spot Price (if we know it)

GET /v1/by-rank

Example:

GET /v1/by-rank

200 OK
{
    "regions": [
            {
                "gid": "fly-arn",
                "id": "arn",
                "intensity": 24,
                "spotScore": 9,
                "spotPrice": {
                    "perSecond": 0.0000323,
                    "perHour": 0.0002,
                    "currency": "USD"
                },
                "instancePrice": {
                    "perSecond": 0.0000423,
                    "perHour": 0.0003,
                    "currency": "USD"
                },
                "notBefore": "2024-09-19T05:23:11+00:00",
                "notAfter": "2024-09-19T08:23:11+00:00",
                "scheduleLimits": {
                    "seconds": 100,
                    "minutes": 2,
                    "hours": 0
                }
            }
    ]
}

By Cloud Provider

Query for the 'greenest' cloud providers

GET /v1/by-provider/{id}

Example:

GET /v1/by-provider/digitalocean

By Country

Query for the lowest carbon regions to schedule your workloads

This is the ISO Alpha2 Country Code, e.g. SE, GB, MX

GET /v1/by-country/{countryCode}

Example:

GET /v1/by-country/SE

By Airport (IATA)

Query for an exact IATA airport code match

The API maps every provider region to an IATA airport code as this is fairly common practice as a way of identifying datacenter regions.

There are some IATA codes which refer to multiple/metropolitan airports all in one go. The currently supported metro IATA are:

LON - LHR, LCY, LGW, STN, LTN
STO - ARN, BMA, VST
PAR - CDG, ORY

Message us if you want another one addedGET /v1/by-iata/{iata}

Example:

GET /v1/by-iata/yyz

Frequently asked questions

Can’t find the answer you’re looking for? Reach out to our customer support team.

Is there a rate limit?: Yes, 60 requests per minute per API key
Can you add a new hosting provider?: Probably, so long as we have the grid data.
Why is the data delayed?: Depending on source we get new data every minute, but the vast majority sit between 15-30 minute delays. Some zones provide data every hour. We exclude data older than an hour as a lot can change in an hour