---
search:
  tags:
    - Offsets
    - POST
seo:
  description: >-
    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.
sidebar:
  label: Get a quote
  badge: POST
title: Get a quote
type: openapi-operation
---
What a purchase would buy and cost at your rate, and whether your balance covers it. Buys nothing.

`POST /quotes`

**Request body** (`application/json`, required)

Exactly one of \`kg\` (whole kg, up to 1,000,000) and \`amount\_cents\`, and an optional \`reference\`.

Request body example, By volume:

```json
{
  "kg": 1000,
  "reference": "fleet-2026-09"
}
```

Request body example, By price:

```json
{
  "amount_cents": 5000
}
```

**Responses**

- `200` — The quote.
- `400` — Bad JSON, or a missing or invalid Idempotency-Key.
- `401` — Missing, unknown or revoked API key.
- `403` — \`api\_access\_inactive\` (the account is suspended or not approved) or \`insufficient\_permissions\` (a read-only key).
- `422` — \`validation\_error\` (with \`param\`) or \`amount\_too\_small\`.
- `429` — \`rate\_limited\`: wait for the \`Retry-After\` seconds.

Response example, 200:

```json
{
  "object": "quote",
  "livemode": true,
  "kg": 0,
  "amount_cents": 0,
  "currency": "usd",
  "rate_millicents_per_kg": 4000,
  "available_cents": 0,
  "sufficient_balance": true,
  "requires_review": true
}
```