This page explains how to retrieve project details from the ekko Climate API. For the full response schema, see the List projects endpoint in the API reference.

This endpoint is useful when you want to display project-level information in your own UI, for example showing consumers the specific projects their contributions or credits support, where they're located and what environmental themes they address.

How it works

Send a GET request to /v3/impact-partners/projects to retrieve the projects run by impact partners.

You can optionally filter by a specific project using the projectId query parameter. If omitted, the API returns all available projects.

Response fields

Field	Type	Description
`id`	UUID	Unique identifier for the project
`impactPartnerId`	UUID	The impact partner that runs this project
`name`	String	Project name
`shortDescription`	String	Brief description of the project
`longDescription`	String	Detailed description of the project
`image`	String	URL to a project image
`type`	String	Project type: `carbonCredits`, `natureCredits` or `contribution`
`subtype`	String	Further classification (e.g. `sequestration`, `carbon removal`). Can be null.
`location`	Object	Where the project operates
`location.countryCode`	String	ISO 3166-1 alpha-3 country code
`location.region`	String	Region within the country
`location.state`	String	State or province
`theme`	String	Environmental theme: `pollution`, `climateStress`, `landUse` or `waterUse`. Can be null.
`unit`	Object	Pricing and unit information for the project
`unit.description`	String	What the unit represents (e.g. `tCO2e`, `Donation`)
`unit.price`	Number	Price per unit
`unit.type`	String	Unit type: `unit` or `monetary`
`unit.currencyCode`	String	ISO currency code for the unit price
`sdgs`	Array	UN Sustainable Development Goals associated with this project
`sdgs[].number`	Number	SDG number
`sdgs[].name`	String	SDG name

Example response

[
  {
    "impactPartnerId": "6b4c2f1d-0c3a-4b6a-9e2e-9ad2f0c4c0f1",
    "id": "dfa40a8a-8c24-404d-bed9-6bc3ee60b2b6",
    "name": "Conservation South Luangwa",
    "shortDescription": "Supporting community-led conservation in Zambia's South Luangwa ecosystem.",
    "longDescription": "This programme strengthens protection for wildlife and habitats while backing local livelihoods. Funding supports rangers, anti-poaching efforts and long-term conservation capacity.",
    "image": "https://cdn.ekko.earth/projects/tusk/south-luangwa/image.png",
    "type": "contribution",
    "subtype": null,
    "sdgs": [
      {
        "number": 15,
        "name": "Life on Land"
      }
    ],
    "location": {
      "countryCode": "ZMB",
      "region": "Eastern Province",
      "state": "South Luangwa"
    },
    "theme": "landUse",
    "unit": {
      "description": "Donation",
      "price": 0.01,
      "type": "monetary",
      "currencyCode": "EUR"
    }
  },
  {
    "impactPartnerId": "9f1c7a0e-52b6-4f5d-9f9d-1d6d4b7f1c2a",
    "id": "6d7a0f9a-1b2c-4d3e-9f10-112233445566",
    "name": "Gender Responsive Safe Water Project",
    "shortDescription": "Improving safe water access in Lango, Uganda while reducing emissions and health risks.",
    "longDescription": "The project supports reliable access to safe water, reducing the need for households to boil water using firewood, which drives deforestation and emissions.",
    "image": "https://cdn.ekko.earth/projects/gold-standard/uganda-water/image.png",
    "type": "carbonCredits",
    "subtype": "sequestration",
    "sdgs": [
      {
        "number": 6,
        "name": "Clean Water and Sanitation"
      },
      {
        "number": 5,
        "name": "Gender Equality"
      }
    ],
    "location": {
      "countryCode": "UGA",
      "region": "Northern Region",
      "state": "Lango"
    },
    "theme": "waterUse",
    "unit": {
      "description": "tCO2e",
      "price": 15.0,
      "type": "unit",
      "currencyCode": "USD"
    }
  }
]

The type field indicates how funds are used. carbonCredits and natureCredits projects sell units of verified impact. contribution projects accept monetary donations directed to conservation work.