---
search:
  tags:
    - Offsets
    - GET
seo:
  description: >-
    Your offsets for this key’s mode, newest first. Reference for the GET
    /offsets endpoint in the TrimCarbon Offset API.
sidebar:
  label: List offsets
  badge: GET
title: List offsets
type: openapi-operation
---
Your offsets for this key’s mode, newest first.

`GET /offsets`

**Responses**

- `200` — A page of offsets.
- `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).
- `404` — \`resource\_missing\`: no such offset for this key.
- `422` — \`validation\_error\` (with \`param\`) or \`amount\_too\_small\`.
- `429` — \`rate\_limited\`: wait for the \`Retry-After\` seconds.

Response example, 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "offset",
      "id": "off_8Hq2kP0aZr4mXc1vB7nT3yLw",
      "livemode": true,
      "status": "processing",
      "kg": 0,
      "amount_cents": 0,
      "currency": "usd",
      "rate_millicents_per_kg": 4000,
      "requested": {
        "kg": 0,
        "amount_cents": 0
      },
      "reference": "string",
      "certificate_url": "http://example.com",
      "created": "2026-10-08T14:03:12.000Z",
      "placed": "2026-10-08T14:03:12.000Z"
    }
  ],
  "has_more": true
}
```