# Alibaba Cloud Carbon Footprint API

> Alibaba Cloud Carbon Footprint API on Apizie: 6 endpoints (Grants authorization, Retrieves aggregated data, Queries the carbon footprint, Retrieves the carbon footprint details of an account, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:aliyun-carbonfootprint/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-carbonfootprint`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/carbonfootprint
- Page: https://apizie.tech/api/cloud/aliyun-carbonfootprint
- OpenAPI: https://apizie.tech/api/cloud/aliyun-carbonfootprint/openapi.json

Alibaba Cloud OpenAPI for Carbon Footprint (carbonfootprint, version 2023-07-11). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Grants authorization
`POST https://apizie.tech/v1/cloud:aliyun-carbonfootprint/allow` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://carbonfootprint.aliyuncs.com |

### Retrieves aggregated data
`POST https://apizie.tech/v1/cloud:aliyun-carbonfootprint/get-summary-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://carbonfootprint.aliyuncs.com |
| StartTime | string | no | The start time for the data query. Format: 2023-01-01 00:00:00 |
| EndTime | string | no | The end time for the data query. Format: 2023-02-01 23:59:59 |
| Group | string | no | The statistical dimension. Valid values: productCode: aggregates by cloud service. region: aggregates by region. subUid: aggregates by RAM… |
| Uids | string | no | The list of Alibaba Cloud account IDs for which you want to query data. Specify this parameter after you enable the multi-account… |

### Queries the carbon footprint
`POST https://apizie.tech/v1/cloud:aliyun-carbonfootprint/query-carbon-track` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://carbonfootprint.aliyuncs.com |
| StartTime | string | no | The start time for the data query. Format: 2023-01-01 00:00:00 |
| EndTime | string | no | The end time for the data query. Format: 2023-02-01 23:59:59 |
| Group | string | no | The statistical dimension. Valid values: productCode: aggregates data by cloud service. region: aggregates data by region. subUid:… |
| Uids | string | no | The list of Alibaba Cloud account IDs for which you want to query data. Specify this parameter after you enable the multi-account… |
| FilterRDAccount | integer | no | Specifies whether to return the carbon emission details of multiple accounts. Specify this parameter after you enable the multi-account… |
| TopNum | integer | no | The number of top entries to return after sorting the results by value in descending order. If this parameter is not specified, all data… |
| UseCode | integer | no | Specifies whether to use the code as the identifier in the response. If this parameter is not specified, the code is used by default.… |

### Retrieves the carbon footprint details of an account
`POST https://apizie.tech/v1/cloud:aliyun-carbonfootprint/query-multi-account-carbon-track` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://carbonfootprint.aliyuncs.com |
| StartTime | string | no | The start time for the query. Format: 2023-01 |
| EndTime | string | no | The end time for the query. Format: 2023-10 |

### Validates account permissions
`POST https://apizie.tech/v1/cloud:aliyun-carbonfootprint/verify` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://carbonfootprint.aliyuncs.com |

### version
`POST https://apizie.tech/v1/cloud:aliyun-carbonfootprint/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://carbonfootprint.aliyuncs.com |

## Example
```
curl "https://apizie.tech/v1/cloud:aliyun-carbonfootprint/allow" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Carbon Footprint API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:aliyun-carbonfootprint/allow with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud Carbon Footprint API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud Carbon Footprint itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud Carbon Footprint API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-carbonfootprint.

### What is the status of the Alibaba Cloud Carbon Footprint API?
Needs your own provider key (bring your own key)