Get Emission Reduction Projects

Get a list of emission reduction projects that can be used to initiate a transaction, including project details per project.

Legend

❓ - clarification will be provided
⚪️ - discontinued
⏳ - TBD
🟡 - supported but requires changes
🟢 - supported

Request

Comparison

TermOld APINew API
Endpoint🟢 GET /api/projects🟡 GET /v1/projects
Currency (displays prices in the preferred currency)🟢 Via a query parameter c (required)🟡 Via a query parameter currency (required). Currently supports EUR, USD.
Authorization🟢 Via a query parameter t (required)🟡 Via the Authorization request header (required)
Localization (displays texts in the preferred language)🟢 Via a query parameter l⏳ TBD

🚧

Cursor-Pagination

The new API implemented cursor based pagination to list remote entries. All endpoints implementing listings return nextPageToken that can be passed into the query string parameter nextPageToken in the next API request.

For example GET /v1/projects?pageSize=20&currency=USD&nextPageToken=XXXXX

Examples

curl --request GET \
  --url 'https://market-api.southpole.com/api/projects?t=token&c=EUR&l=en' \
  --header 'Content-Type: application/json'
curl --request GET \
   --url 'https://dcs-compensate-api-sandbox.southpole.com/v1/projects?pageSize=20&currency=USD' \
   --header 'accept: application/json' \
   --header 'authorization: Bearer token'

Cursor Pagination

Response

Comparison

Data Model (JSON path)Old APINew API
Status🟢 status⚪️ Removed in favour of the HTTP client response status field
Project ID🟢 projects[].no🟡 projects[].id has a new value. Old value isn't indexed but can be read from projects[].notes.id
Name🟢 projects[].name🟢 projects[].name
Description🟢 projects[].description🟡projects[].solution
Context🟢 projects[].context🟡projects[].story
Benefits🟢 projects[].benefits🟡projects[].impact
Country🟢 projects[].country🟡 projects[].country (enum of countries)
Technology🟢 projects[].technology🟡 projects[].technologies is an array of strings.
Price🟢 projects[].price🟡 projects[].credits.pricePerItem.amount is a string (long double)
Currency🟢 projects[].currency🟡 projects[].credits.pricePerItem.currency is a string. Depends on the currency query string parameter.

Examples

{
  "status": "ok",
  "projects": [
    {
      "no": 300758,
      "name": "Za Hung Hydro, Vietnam",
      "description": "The Za Hung hydropower project is situated at the A Vuong River in the Quang Nam province, in the South Central region of Vietnam. The plant is helping to bridge the supply-demand gap in the region by meeting them demands of almost 20,000 homes with clean energy.",
      "context": "Power consumption in Vietnam has been growing significantly for the last several years. However, with coal-fired power plants dominating the energy system, nationally GHG emissions are climbing higher and higher and local to the plant residents suffer from poor air quality. Meeting increasing energy demands with hydropower is part of a plan the Vietnamese government's plan to support further sustainable development with clean energy.",
      "benefits": "The project supports sustainable development in the region by creating stable well-paid jobs for locals and offering on-going training opportunities in health and safety and plant operations. In addition to the fund for flood-affected households, the project annually donates money to support disadvantaged people in the commune. Thanks to the Za Hung project, local communities are benefiting from improved electricity, drainage, roads, and better air quality.",
      "country": "Vietnam",
      "technology": "Hydropower",
      "price": 16.95,
      "currency": "USD"
    }
  ]
}
{
  "nextPageToken": "eyJsYXN0X2lkIjo3NjE5MjY3MTk5MTMzLCJsYXN0X3ZhbHVlIjo3NjE5MjY3MTk5MTMzfQ==",
  "projects": [
    {
      "country": "THA",
      "credits": {
        "pricePerItem": {
          "amount": "6",
          "currency": "EUR"
        },
        "stock": {
          "quantity": "26872",
          "unit": "t"
        }
      },
      "id": "7619267199133",
      "impact": "The project has significantly improved local air and water quality. At the same time, the fossil fuel use of the starch plant has been significantly reduced. The project and the carbon revenue it generates provides jobs for locals and supports social and educational activities. The clean wastewater is used to irrigate nearby fields and allows fish farming, enabling local communities to increase their income.",
      "media": {
        "images": [
          {
            "height": 642,
            "url": "https://cdn.shopify.com/s/files/1/0622/3862/1853/products/southpole059-02_1920x768_1600x642_8e87fade-e3dc-4994-b7cf-3fe07df1e7e1.jpg?v=1673877088",
            "width": 1600
          },
          {
            "height": 642,
            "url": "https://cdn.shopify.com/s/files/1/0622/3862/1853/products/southpole059-03_1920x768_1600x642_de2f76f1-598f-4697-a8ad-14bd6907a8ac.jpg?v=1673877088",
            "width": 1600
          },
          {
            "height": 961,
            "url": "https://cdn.shopify.com/s/files/1/0622/3862/1853/products/0059_Nakhon_biogas_Photo_2_1600x961_0fa87719-0652-45a4-943c-2a24af046c4c.jpg?v=1673877088",
            "width": 1600
          },
          {
            "height": 1200,
            "url": "https://cdn.shopify.com/s/files/1/0622/3862/1853/products/0059_Nakhon_biogas_Photo_3_1600x1200_f16d4897-7b70-4365-b916-6fa3777ec594.jpg?v=1673877088",
            "width": 1600
          },
          {
            "height": 961,
            "url": "https://cdn.shopify.com/s/files/1/0622/3862/1853/products/0059_Nakhon_Biogas_Photo_5_1600x961_27d68c96-ab1c-4025-935e-c99e0cb5d912.jpg?v=1673877088",
            "width": 1600
          },
          {
            "height": 961,
            "url": "https://cdn.shopify.com/s/files/1/0622/3862/1853/products/0059_Nakhon_Biogas_Photo_6__1__1600x961_2594be2f-1fe3-4b19-9dfe-3013ab4519a2.jpg?v=1673877088",
            "width": 1600
          },
          {
            "height": 961,
            "url": "https://cdn.shopify.com/s/files/1/0622/3862/1853/products/0059_Nakhon_1_1600x961_183da3b3-3e9d-4d91-82e1-a150552b45cb.jpg?v=1673877088",
            "width": 1600
          },
          {
            "height": 961,
            "url": "https://cdn.shopify.com/s/files/1/0622/3862/1853/products/0059_Nakhon_4_1600x961_72e06f36-c026-410f-b1df-14e50dafc135.jpg?v=1673877088",
            "width": 1600
          }
        ],
        "videos": []
      },
      "name": "Nakhon Biogas",
      "notes": {
        "id": "300059"
      },
      "region": "142",
      "registries": [
        {
          "category": "Carbon",
          "id": "560",
          "url": "https://registry.goldstandard.org/projects/details/981"
        },
        {
          "category": "Carbon",
          "id": "2141",
          "url": "https://cdm.unfccc.int/Projects/DB/RWTUV1218617500.62/view"
        },
        {
          "category": "Carbon",
          "id": "2261",
          "url": "https://registry.verra.org/app/projectDetail/VCS/2261"
        }
      ],
      "sdgs": [
        6,
        7,
        8,
        13
      ],
      "solution": "Prior to this project, wastewater was treated through cascading open lagoons. This process resulted in the steady release of methane into the atmosphere. This project installed a closed lagoon anaerobic system that captures methane gas emissions, and uses them to generate clean energy. This not only avoids the emission of potent greenhouse gases, but displaces energy sourced from the burning of fossil fuels.",
      "standards": [
        "cer",
        "gscer",
        "gsver",
        "vcu"
      ],
      "story": "Cassava starch is a large industry in Thailand, but its production produces large amounts of wastewater. When stored in large open lagoons, this wastewater emits methane into the atmosphere; a greenhouse gas 21 times more potent than CO2.",
      "tagline": "Generating sustainable electricity from wastewater biogas",
      "technologies": [
        "Biogas recovery",
        "Wastewater treatment",
        "Sludge treatment"
      ],
      "vintages": [
        2020,
        2019,
        2021
      ]
    }
  ]
}