---
search:
  tags:
    - Account
    - GET
seo:
  description: >-
    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.
sidebar:
  label: Get the balance
  badge: GET
title: Get the balance
type: openapi-operation
---
The balance this key spends, and your rate. Test keys see a simulated balance.

`GET /balance`

**Responses**

- `200` — The balance.
- `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).
- `429` — \`rate\_limited\`: wait for the \`Retry-After\` seconds.

Response example, 200:

```json
{
  "object": "balance",
  "livemode": true,
  "available_cents": 0,
  "currency": "usd",
  "rate_millicents_per_kg": 4000
}
```