Access details about carbon offset projects and their vintages. The screenshot below is of the project detail screen which shows similar data as this endpoint returns:
Example cURL Request
curl --request GET 'https://${BASE_URL}/api/projects?project_ids[]=003q81qxjb6rru572v&project_ids[]=0037yhin9rxb2v8coh' \
--header'Authorization: Bearer ${API_KEY}'
Endpoint Specification
Get project data
GET/api/projects
Get detailed project and vintage data for multiple projects
Query Parameters
Headers
{"projects": [ {"project_id":"003s9eb104zcu2gclk","project_name":"Example Hydro project","type":"Hydro","location":"TD","registry_project_url":"https://example.com/","sdgs": ["Life Below Water","Gender Equality","Infrastructure","Quality Education","Zero Hunger","Health and Well Being","No Poverty","Water Benefit","Economic Growth" ],"registry_id":"005h8koa2ioo0qgq3x","registry_name":"BioCarbon Registry", "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
"vintages": [ {"vintage_id":"004bjccxq1p4j6f954","vintage_year":2014,"registry_vintage_url":"https://example.com/" }, {"vintage_id":"0042g006orga6wll64","vintage_year":2019,"registry_vintage_url":"https://example.com/" }, {"vintage_id":"004wk8qmn51yjftw7g","vintage_year":2020,"registry_vintage_url":"https://example.com/" } ] } ]}
{"error":"Forbidden","message":"Permission denied according to assigned roles.","statusCode":403}
{ statusCode: number message: string error: string}
{"statusCode":500,"message":"Internal server error"}
{ statusCode: number message: string}
Project Data
Registry Ids and Names
Thallo will return both the registry_id and the registry_name for convenience. Please note the registry name is a label and may change, however the registry id will remain static.
Value Values
Easy to copy values
005h8koa2ioo0qgq3x BioCarbon Registry
005yuwbp97mxjnk122 Puro.earth
005a86q13pgj9c3612 Gold Standard
005y75kep1v7snof1x American Carbon Registry
0050yd569dw0qbw5oy VERRA
0056bnn0ernrsikdbr UNFCCC Clean Development Mechanism
0057qpby5eqk470euc Cercarbono / EcoRegistry
005oymz2l3624dokjf Climate Action Reserve
005r76093fm1wjqd13 Plan Vivo
005yuwbp97mxjnklnz Global Carbon Council
005vgugi19i1pqveb6 Centigrade
005c5sqk87b8fdjtmv Social Carbon
Sustainable Development Goals (SDGs)
What are SDGs?
The 17 Sustainable Development Goals (SDGs) are an urgent call for action by all countries - developed and developing - in a global partnership. They recognize that ending poverty and other deprivations must go hand-in-hand with strategies that improve health and education, reduce inequality, and spur economic growth – all while tackling climate change and working to preserve our oceans and forests. Read more.
A carbon project can satisfy none, one or multiple SDGs during its implementation, which indicates additional co-benefits beyond carbon reduction or removal.
Valid Values
Easy to copy values
No Poverty
Zero Hunger
Health and Well Being
Quality Education
Gender Equality
Water Benefit
Clean Energy
Economic Growth
Infrastructure
Reduced Inequalities
Sustainable Cities
Responsible Consumption and Production
Climate Action
Life Below Water
Life On Land
Peace and Justice
Partnerships for the Goals
Project Types
Project types are not standardized across registries, however, Thallo map these values into a single set of project types to allow you to easily filter and analyze projects regardless of which registry they originate from.
Valid Values
Easy to copy values
Afforestation, Reforestation & Restoration
Agricultural Methane Recovery
Avoided Deforestation
Biochar
Bioenergy Carbon Capture & Storage
Biogas
Biomass
Boreholes
Brick Manufacturing
Carbonated Building Materials
Cement & Concrete
Cookstoves
Direct Air Capture
Domestic Energy Efficiency
Domestic Fuel Efficiency - Biodigesters
Domestic Fuel Efficiency - Lighting
Energy Efficiency
Enhanced Oil Recovery
Enhanced Weathering
Feed Additives
Fuel Switch
Fugitive Emissions
Geologically Stored
Geothermal
Grasslands
Hydro
Improved Forest Management
Industrial Energy Efficiency
Irrigation
Landfill Gas
Mangroves
Metal production
Methane Capture
N2O from Adipic Acid
N2O from Nitric Acid
Non-Oil Recycling
Oil Recycling
Other transport
Ozone Depleting Substances
Peatlands
REDD+
Regenerative Agriculture
Renewables
Seagrass & Seaweeds
Soil Amendment based on Carbon Storage Methodology
Solar
Sulphur Emissions
Synthetic Fuels
Waste Heat Recovery
Water
Water Filters
Wetland Restoration
Wind
Wooden Building Materials
Woody Biomass Burial
Project Locations
Thallo follow the ISO 3166-1 alpha-2 standard for 2 letter country codes.
Valid Values
Easy to copy values
AD Andorra
AE United Arab Emirates
AF Afghanistan
AG Antigua and Barbuda
AI Anguilla
AL Albania
AM Armenia
AO Angola
AR Argentina
AS American Samoa
AT Austria
AU Australia
AW Aruba
AX Åland Islands
AZ Azerbaijan
BA Bosnia and Herzegovina
BB Barbados
BD Bangladesh
BE Belgium
BF Burkina Faso
BG Bulgaria
BH Bahrain
BI Burundi
BJ Benin
BL Saint Barthélemy
BM Bermuda
BN Brunei Darussalam
BO Bolivia
BQ Bonaire, Sint Eustatius and Saba
BR Brazil
BS Bahamas
BT Bhutan
BW Botswana
BY Belarus
BZ Belize
CA Canada
CC Cocos (Keeling) Islands
CD Democratic Republic of the Congo
CF Central African Republic
CG Congo
CH Switzerland
CK Cook Islands
CL Chile
CM Cameroon
CN China
CO Colombia
CR Costa Rica
CU Cuba
CW Curaçao
CX Christmas Island
CY Cyprus
CZ Czechia
DE Germany
DJ Djibouti
DK Denmark
DM Dominica
DO Dominican Republic
DZ Algeria
EC Ecuador
EE Estonia
EG Egypt
EH Western Sahara
ER Eritrea
ES Spain
ET Ethiopia
FI Finland
FJ Fiji
FK Falkland Islands
FM Micronesia
FO Faroe Islands
FR France
GA Gabon
GB United Kingdom
GD Grenada
GE Georgia
GG Guernsey
GH Ghana
GI Gibraltar
GL Greenland
GM Gambia
GN Guinea
GQ Equatorial Guinea
GR Greece
GT Guatemala
GU Guam
GW Guinea-Bissau
GY Guyana
HK Hong Kong
HN Honduras
HR Croatia
HT Haiti
HU Hungary
ID Indonesia
IE Ireland
IL Israel
IM Isle of Man
IN India
IO British Indian Ocean Territory
IQ Iraq
IR Iran
IS Iceland
IT Italy
JE Jersey
JM Jamaica
JO Jordan
JP Japan
KE Kenya
KG Kyrgyzstan
KH Cambodia
KI Kiribati
KM Comoros
KN Saint Kitts and Nevis
KP North Korea
KR South Korea
KW Kuwait
KY Cayman Islands
KZ Kazakhstan
LA Lao People's Democratic Republic
LB Lebanon
LC Saint Lucia
LI Liechtenstein
LK Sri Lanka
LR Liberia
LS Lesotho
LT Lithuania
LU Luxembourg
LV Latvia
LY Libya
MA Morocco
MC Monaco
MD Moldova
ME Montenegro
MG Madagascar
MH Marshall Islands
MK North Macedonia
ML Mali
MM Myanmar
MN Mongolia
MO Macao
MP Northern Mariana Islands
MQ Martinique
MR Mauritania
MS Montserrat
MT Malta
MU Mauritius
MV Maldives
MW Malawi
MX Mexico
MY Malaysia
MZ Mozambique
NA Namibia
NE Niger
NF Norfolk Island
NG Nigeria
NI Nicaragua
NL Netherlands
NO Norway
NP Nepal
NR Nauru
NU Niue
NZ New Zealand
OM Oman
PA Panama
PE Peru
PF French Polynesia
PG Papua New Guinea
PH Philippines
PK Pakistan
PL Poland
PN Pitcairn
PR Puerto Rico
PS Palestine, State of
PT Portugal
PW Palau
PY Paraguay
QA Qatar
RO Romania
RS Serbia
RU Russian Federation
RW Rwanda
SA Saudi Arabia
SB Solomon Islands
SC Seychelles
SD Sudan
SE Sweden
SG Singapore
SI Slovenia
SK Slovakia
SL Sierra Leone
SM San Marino
SN Senegal
SO Somalia
SR Suriname
SS South Sudan
ST Sao Tome and Principe
SV El Salvador
SX Sint Maarten
SZ Eswatini
TD Chad
TL Timor-Leste
TN Tunisia
TR Türkiye
TT Trinidad and Tobago
UA Ukraine
US United States of America
UY Uruguay
VC Saint Vincent and the Grenadines
VE Venezuela
VG Virgin Islands (British)
VI Virgin Islands (U.S.)
VN Viet Nam
VU Vanuatu
WS Samoa
YE Yemen
ZA South Africa
ZM Zambia
ZW Zimbabwe
