---
title: "The account's completed offset purchases"
method: GET
path: "/v1/offsets/history"
tags: ["Offsets"]
---

# The account's completed offset purchases

`GET /v1/offsets/history`

## Request

- Base URL: `https://carbonguru.io`
- URL: `https://carbonguru.io/v1/offsets/history`
- Auth: HTTP bearer

Newest first, cursor-paged. next_cursor is opaque and the Link header carries the same cursor as rel="next"; it is present when this page came back full, because the shipped read reports no total. count is the number of purchases on this page. Customer prices only: the ledger behind it holds the supplier cost and CarbonGuru's fee and neither is served.

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

A page of offset purchases.

- object
  - `purchases` object[], required
    - `carbonguru_id` string, nullable
    - `item_name` string, nullable
    - `type` 'offset' | 'removal' | 'null', nullable
    - `carbon_kg` number, nullable
    - `cost_usd` number, nullable: What was paid to offset it.
    - `social_cost_usd` number, nullable
    - `status` string, nullable: delivered, processing, failed, canceled, refunded or pending.
    - `order_id` string, nullable
    - `order_total_usd` number, nullable
    - `item_price_usd` number, nullable: What the analysed item itself cost. Not part of the offset price.
    - `purchased_at` string, nullable
  - `count` integer, required
  - `next_cursor` string, nullable, required

## Other responses

- `401`: No valid credential. Every authentication failure returns this one document.
- `402`: The account's plan does not include this capability. Carries min_tier and upgrade_url.
- `403`: A missing scope, an exhausted analysis allowance, or an object that is not the caller's.
- `404`: No such resource.
- `422`: The request's fields are wrong. errors[] names them.

---

[API](https://skmtc.dev/carbonguru/apis/carbonguru-api.md) · [All operations](https://skmtc.dev/carbonguru/apis/carbonguru-api/llms.txt) · [OpenAPI document](https://skmtc.dev/carbonguru/apis/carbonguru-api/revisions/26dcbe7a8500?raw)