---
title: "Retirement Credit Batches"
method: GET
path: "/retirements/{id}/credit_batches"
---

# Retirement Credit Batches

`GET /retirements/{id}/credit_batches`

List of credit batches for a given retirement.

## Path parameters

- `id` string, required

## Headers

- `x-client-secret` string, required — A secret token identifying the client connecting to the API

## Response `200`

Successful Response

- ListResourceCreditBatch
  - `nodes` CreditBatch[], required
    - `id` string, required
    - `serial_number` string, required
    - `status` 'active' | 'split' | 'retired', required
    - `size` CreditQuantity, required
      - `credits` number, required — A representation of the credit quantity as a fractional amount, to 3 decimal places. Where 1 unit represents 1 credit and 1 ton of CO₂e.
      - `credit_kgs` integer, required — A representation of the credit quantity as an integer kilogram amount. Where 1 unit represents 0.001 credits and 1 kilogram of CO₂e. This field can handle bigint values.
    - `issued_at` string, date-time, required
    - `retired_at` string, date-time, nullable, required
    - `delivered_at` string, date-time, nullable, required
    - `sequestered_on` string, date, required
    - `country_of_issue` string, required — An ISO 3166-1 alpha-3 country code
    - `supplier_id` string, required
    - `parent_id` string, nullable, required — If this credit batch was created from splitting a larger batch in two, this will be set to the id of the parent credit batch.
    - `left_child_id` string, nullable, required — If this credit batch has status `SPLIT`, it will have two child batches representing the two halves of this split.
    - `right_child_id` string, nullable, required — If this credit batch has status `SPLIT`, it will have two child batches representing the two halves of this split.
    - `issuance_id` string, required
    - `delivery_id` string, nullable, required
    - `beneficiary` Organisation, required
      - `id` string, required
      - `name` string, required
      - `domain` string, nullable, required
    - `retirement_id` string, nullable, required
    - `ghg_entry_id` string, required
    - `removal_id` string, required — Deprecated, please use `ghg_entry_id` instead.
    - `owner` Organisation, required
      - `id` string, required
      - `name` string, required
      - `domain` string, nullable, required
    - `project_id` string, required
    - `carbon_removal_data` CarbonRemovalData, required
      - `gross_carbon_removed_kg` integer, required
      - `net_carbon_removed_kg` integer, required
      - `emissions_kg` integer, required
      - `counterfactuals_kg` integer, required
      - `losses_kg` integer, required
    - `ccp_approved` boolean, required — Whether this credit batch has been issued as part of a ICVCM Core Carbon Principles (CCP) approved project
  - `total_count` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/isometric/apis/isometric-registry-api.md) · [All operations](https://skmtc.net/isometric/apis/isometric-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/isometric/isometric-registry-api/versions/2e31eeb1cb99/schema)