# TrimCarbon API

> Buy carbon offsets from your own systems with the TrimCarbon Offset API.

## Docs

- [TrimCarbon Offset API](https://trimcarbon.com/docs): Buy carbon offsets from your own systems, paid from a prepaid balance.
- [Quickstart](https://trimcarbon.com/docs/quickstart): Make your first purchase with a test key, then go live.
- [Authentication](https://trimcarbon.com/docs/authentication): API keys, live and test modes, and access levels.
- [Test mode](https://trimcarbon.com/docs/test-mode): Build and test your integration without spending money.
- [Idempotency](https://trimcarbon.com/docs/idempotency): Retry a purchase safely, without buying twice.
- [Balance and purchases](https://trimcarbon.com/docs/balance): Top-ups, your rate, how a purchase is priced, and what happens to the balance.
- [Errors](https://trimcarbon.com/docs/errors): Status codes, error codes, and what to do about each.
- [Limits](https://trimcarbon.com/docs/limits): Rate limits and the size of a purchase.
- [Versioning](https://trimcarbon.com/docs/versioning): How the API changes, and how we tell you.

## Reference

- [TrimCarbon Offset API](https://trimcarbon.com/docs/reference): Buy carbon offsets from your own systems. Your account has a prepaid USD balance; each purchase takes its cost from the balance, and we buy and retire the…

### Offsets

- [Buy offsets](https://trimcarbon.com/docs/reference/offsets/create-offset): Takes the cost from your balance and orders the credits. The offset starts as… Reference for the POST /offsets endpoint in the TrimCarbon Offset API.
- [List offsets](https://trimcarbon.com/docs/reference/offsets/list-offsets): Your offsets for this key’s mode, newest first. Reference for the GET /offsets endpoint in the TrimCarbon Offset API.
- [Get an offset](https://trimcarbon.com/docs/reference/offsets/get-offset): One offset and its status. Once placed, certificate_url links to its public… Reference for the GET /offsets/{id} endpoint in the TrimCarbon Offset API.
- [Get a quote](https://trimcarbon.com/docs/reference/offsets/create-quote): What a purchase would buy and cost at your rate, and whether your balance covers it.… Reference for the POST /quotes endpoint in the TrimCarbon Offset API.

### Account

- [Get the balance](https://trimcarbon.com/docs/reference/account/get-balance): The balance this key spends, and your rate. Test keys see a simulated balance. Reference for the GET /balance endpoint in the TrimCarbon Offset API.
- [Get your API impact](https://trimcarbon.com/docs/reference/account/get-impact): kg of CO₂ offset through the API, for this key’s mode. Reference for the GET /impact endpoint in the TrimCarbon Offset API.

## Agent skills

- [trimcarbon-api](https://trimcarbon.com/docs/.well-known/agent-skills/trimcarbon-api/SKILL.md): Read the TrimCarbon API docs instead of answering from memory. Buy carbon offsets from your own systems with the TrimCarbon Offset API. Use when a task involves TrimCarbon API: how it works, how to set it up or configure it, or its API.

## Agent resources

- [llms-full.txt](https://trimcarbon.com/docs/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://trimcarbon.com/docs/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://trimcarbon.com/docs/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://trimcarbon.com/docs/openapi.json.
- [Agent skills](https://trimcarbon.com/docs/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://trimcarbon.com/docs/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://trimcarbon.com/docs/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://trimcarbon.com/docs/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://trimcarbon.com/docs/sitemap.xml): Every indexable page URL with its last-modified date.