---
title: "Organisation Credit Batches"
method: GET
path: "/organisations/{id}/credit_batches"
---

# Organisation Credit Batches

`GET /organisations/{id}/credit_batches`

A paginated list of all credit batches currently owned or retired on behalf of the organisation, sorted by issuance date. By default it excludes batches with the status 'split'.

Note that when combining filters, the result will be the intersection of them. For example, when filtering by `supplier_id` and `issued_after`, the result will only include credit batches from the specified supplier that have been issued after the specified date.

## Path parameters

- `id` string, required

## Query parameters

- `supplier_id` string
- `project_id` string
- `issuance_id` string
- `delivery_id` string
- `order_id` string
- `retirement_id` string
- `status` CreditBatchStatus[], nullable — Filter credit batches by status. Note that 'split' status is excluded by default.
- `issued_after` string, date-time, nullable — Filter credit batches to only return ones issued strictly after this timestamp. Format: ISO8601-like including timezone, eg. 2021-01-01T00:00:00Z
- `issued_before` string, date-time, nullable — Filter credit batches to only return ones issued strictly before this timestamp. Format: ISO8601-like including timezone, eg. 2024-01-01T00:00:00Z
- `last` integer — An integer number of items to retrieve before the item represented by the cursor passed in the before parameter. Defaults to 10 with a maximum value of 50.
- `before` string, nullable — An opaque cursor representing the first item in the previously requested page to select items ordered before it. Submit the previously requested page’s start_cursor here when paginated backwards.
- `first` integer — An integer number of items to retrieve after the item represented by the cursor passed in the after parameter. Defaults to 10 with a maximum value of 50.
- `after` string, nullable — An opaque cursor representing the last item in the previously requested page to select items ordered after it. Submit the previously requested page’s end_cursor here when paginated forwards.
- `sort_field` 'issued_at'
- `sort_direction` 'asc' | 'desc'

## Headers

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

## Response `200`

Successful Response

- PaginatedListResourceCreditBatch
  - `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
  - `page_info` PageInfo, required
    - `has_previous_page` boolean, required
    - `start_cursor` string, nullable, required
    - `has_next_page` boolean, required
    - `end_cursor` string, nullable, 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/revisions/2e31eeb1cb99/schema)