Find carbon projects by country

You can search for carbon projects listed on Carbonmark by country.

Each API endpoint will link to its reference documentation where you can create sample requests in other programming languages as well as enter the parameters you desire.

First, retrieve an array containing the countries that carbon projects originate from by calling the /Countries endpoint. Here's a sample of a request:

curl --request GET \
  --url https://api.carbonmark.com/countries \
  --header 'Accept: application/json'

You'll receive a JSON response containing an array with country ids that looks like this:

[
  {
    "id": "Brazil"
  },
  {
    "id": "Bulgaria"
  },
  {
    "id": "China"
  },
  {
    "id": "Congo"
  },
  {
    "id": "Ecuador"
  },
  {
    "id": "India"
  },
  {
]

From these countries, select your choice of country. Next, we'll call the /carbonProjects endpoint with our desired query parameters. The endpoint allows you to retrieve an array of carbon projects filtered by category, country, vintage, project names, and project descriptions.

In this example, we'll search for renewable energy carbon projects originating from India with a 2012 vintage. Here's the example request:

The response you may receive will contain a list of all carbon projects that match your query parameters. Below we've listed an example of two of the carbon projects from the response:

The information from this response such as "key" and "projectID" may be enough for your needs.

You can retrieve the full details of a carbon project by its using the project key; api.carbonmark.com/carbonProjects/{id}. For example:

The response will contain the full carbon project details:

Last updated