---
title: "Delivery Credit Batches"
method: GET
path: "/deliveries/{id}/credit_batches"
---

# Delivery Credit Batches

`GET /deliveries/{id}/credit_batches`

## Request

- Base URL: `https://api.isometric.com/registry/v0`
- URL: `https://api.isometric.com/registry/v0/deliveries/{id}/credit_batches`
- Auth: HTTP bearer

List of credit batches for a given delivery.

Note these are the original batches in the delivery, so some credit batches might be in status SPLIT if they had to be split for a 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

- ListResourceCreditBatch
  - `nodes` CreditBatch[], required
    - `id` string, required
    - `serial_number` string, required
    - `status` 'active' | 'split' | 'retired', required
    - `credit_type` 'reduction' | 'removal', 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

## Changes

- **2026-10-30** `385518aba17d`: 1 breaking, 1 warning, 1 info
  - for the `path` request parameter `id`, the minLength was increased from `0` to `20`
  - for the `path` request parameter `id`, the maxLength was set to `37`
  - for the `path` request parameter `id`, the type was generalized from no type to `string`
- **2026-10-28** `4151a53aef0f`: 1 info
  - added the required property `nodes/items/credit_type` to the response with the `200` status
- **2026-08-05** `2e31eeb1cb99`: 1 info
  - the `nodes/items/country_of_issue` response's property pattern `^[A-Z]{3}$` was added for the status `200`
- **2026-08-04** `f1623e0dc2e1`: 7 info
  - for the `path` request parameter `id`, the type was generalized from `string` to no type
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
  - response property `nodes/items/removal_id` deprecated
  - …3 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/isometric/apis/isometric-registry-api/changes/deliveries/:id/credit_batches/get.md)

---

[API](https://skmtc.dev/isometric/apis/isometric-registry-api.md) - [All operations](https://skmtc.dev/isometric/apis/isometric-registry-api/llms.txt) - [OpenAPI document](https://skmtc.dev/isometric/apis/isometric-registry-api/revisions/385518aba17d?raw)