---
title: "Issuance Credit Batches"
method: GET
path: "/issuances/{id}/credit_batches"
---

# Issuance Credit Batches

`GET /issuances/{id}/credit_batches`

List of credit batches for a given issuance.

Credit batches are divided between those allocated to the buffer pool and those allocated to the supplier. Note these are the original batches in the issuance, so some credit batches might be in status SPLIT if they had to be split for a delivery/transfer/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

- IssuanceCreditBatches
  - `issuance_id` string, required
  - `supplier_credit_batches` 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
  - `supplier_credit_batch_size_total` 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.
  - `buffer_pool_credit_batches` 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
  - `buffer_pool_credit_batch_size_total` 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.
  - `credit_batch_size_total` 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.

## 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)