# Welcome to the Thallo API

<figure><img src="https://389206920-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn0oY4dP81ezKSkZC4sfF%2Fuploads%2Fgit-blob-13e80e89be508ab886ce8f5c7a5e31562b908e3d%2FthalloLogoWhite.png?alt=media" alt="Thallo logo"><figcaption></figcaption></figure>

## Thallo API

Carbon-as-a-Service is a single API solution that gives businesses instant access to millions of carbon credits across the entire carbon market. It allows businesses to easily and automatically embed high-quality, verified carbon credits into their products and services, with just a few lines of code.

It allows you to programmatically access Thallo's aggregated carbon credit market, pulling the rich details of carbon offset projects from multiple registries into one standard and easy to consume format. The Thallo API allows you to purchase carbon credits by the tonne and retire down to the gram with one simple request.

## Thallo Account and API Key

You will need an API key in order to access the API. If you already have a Thallo account please contact your account manager to retrieve your API key. If you do not have a Thallo account please contact [sales@thallo.io](mailto:sales@thallo.io?subject=Thallo%20account%20with%20API%20access) to open an account and get your API key.

## Thallo SDK

If you are using an NPM compatible framework/runtime, such as [Node.js](https://nodejs.org/), Thallo recommend using our [Thallo SDK](https://github.com/thallo-io/thallo-exchange-npm-sdk/) NPM library.

## Thallo API Direct Access

If you cannot use NPM or do not wish to use the Thallo SDK, you can achieve all of your carbon credit business goals by accessing the Thallo API directly.

This documentation will walk you through all of the available endpoints and best practices to allow you to embed carbon into your existing products, systems and services.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.market.thallo.io/public.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.