How to obtain the carbon footprint of your OVHcloud services

Objective

As part of your professional activities or out of interest on the subject, you may need to calculate the carbon footprint of your services.

Find out how to retrieve the monthly carbon footprint of your OVHcloud services.

Requirements

• Being the billing contact for the service(s) you would like to create a carbon footprint for. For more information, see our guide to managing contacts.

The carbon footprint calculation is available for the following services:

• Dedicated Server (Advance, Game, Scale, High Grade, Storage)
• Eco Dedicated Server (Rise, Kimsufi, So You Start)
• VMware on OVHcloud
• Public Cloud

Instructions

Please note the following information:

• You cannot generate a carbon footprint report for the current month.
• When using the OVHcloud API, whether you enter a date at the beginning, middle or end of the month for the month chosen, the carbon footprint report will be generated for the full month.
• No carbon footprint report can be generated for more than the last 24 months.
• No carbon footprint can be generated before the date of implementation of the feature for each OVHcloud service (see table below).

Availability of carbon footprint data:

Retrieving the monthly carbon footprint report for the previous month via the OVHcloud Control Panel

1. Log in to the OVHcloud Control Panel.
2. On the page that opens, scroll down to the Useful links section in the left-hand column, then click on the My carbon footprint tab.
3. On the new page that appears, click Download my [Month] [Year] footprint.

You can recover the carbon footprint of the previous month for your eligible services every month.

If you need the carbon footprint for a month prior to the month preceding the current month, you will have to use our APIs to retrieve it.

Retrieving a monthly carbon footprint prior to the previous month via our APIs

By default, OVHcloud APIs are made available to developers or integrators to associate features, such as those not present in the OVHcloud Control Panel, directly with their applications or solutions.

Step 1 - Log in to the OVHcloud APIs

• Go to our OVHcloud API website (check that you are on https://eu.api.ovh.com if your services are hosted in Europe, and on https://ca.api.ovh.com if they are hosted outside Europe).
• On the page that pops up, click Explore the OVHcloud API.
• On the left-hand side of the new page that appears, go to the form to the right of the v1 field, then select/enter the choice /me.
• From the list of APIs that appear below in the left-hand column, locate and click the following API: POST /me/carbonCalculator/task. You can also access it directly via the API call below:

• On the right-hand side of the page, you will then see the API with its fields to complete.
• Click the button in the top right-hand corner labeled Authenticate, then the Login with OVHcloud SSO button.
• The interface for connecting to your OVHcloud Control Panel will open.
• Log in with your customer credentials, then click Authorize to use the OVHcloud APIs with your services.
• You will then be automatically redirected to the previous page of the POST /me/carbonCalculator/task API.

Step 2 - Request the carbon footprint generation and retrieve the requested Task ID

Replace the current date that appears in the API sidebar with the date on which you want to stop calculating the carbon footprint. Please respect the following date format:

{
  "date": "YYYY-MM-DD"
}

Once you have chosen the correct date, click the blue EXECUTE button.

If everything has been done correctly, a taskID will appear in the RESPONSE window when you scroll down the page below the EXECUTE button.

For example, if your OVHcloud account ID is aa00000-ovh and the date you selected earlier is 2025-01-31, then you will get the following result:

{
  "taskID": "aa00000-ovh_202501"
}

Copy only the obtained value which must be equivalent to the value of our example aa00000-ovh_202501 (without copying the quotation marks (")).

Step 3 - Retrieve the carbon footprint report in PDF format

Thanks to the taskID value previously retrieved, you can now retrieve the carbon footprint of your services in PDF format.

To do this, stay on our OVHcloud API website and perform the following actions:

• On the left-hand side of the page, go to the form to the right of the v1 field, then select/enter the choice /me.
• From the list of API calls that appear below, locate and click the following API: GET /me/carbonCalculator/task/{taskID}. You can also access it directly via the API call below:

• On the right-hand side of the page, you will then see the API with a form to fill in.

Complete the form in the PATH PARAMETERS section as follows:

• taskID: Copy here the taskID value retrieved earlier in step 2.

Once you have entered the value for your taskID correctly, click the blue EXECUTE button.

The following result appears in the RESPONSE window when you scroll down the page below the EXECUTE button:

{
  "link": "Find here the complete URL to download the carbon footprint in PDF format",
  "status": "SUCCESS",
  "taskID": "aa00000-ovh_202501"
}

In this result, copy the entire URL in "HTTPS" (without the quotation marks) on the right-hand side of the comment "link":, then paste it into the search bar of your web browser to start downloading the carbon footprint in PDF format.

Your web browser will automatically download the file and then display it.

Once you have opened the file, you will find the following items:

• A summary table of C02 emissions by category for the requested month.
• A summary table of C02 emissions by category between the beginning of the calendar year and the requested month.
• A table detailing the values by type of product subscribed.
• A graph showing C02 emissions by category.

Go further

First Steps with the OVHcloud APIs

For specialised services (SEO, development, etc.), contact OVHcloud partners.

Join our community of users.