GET
/
credit_batches
/
{id}
curl --request GET \
  --url https://api.sandbox.isometric.com/registry/v0/credit_batches/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'x-client-secret: <x-client-secret>'
{
  "beneficiary": {
    "domain": "isometric.com",
    "id": "org_1GB56M1ST1S0GVNA",
    "name": "Isometric"
  },
  "carbon_removal_data": {
    "counterfactuals_kg": 123,
    "emissions_kg": 123,
    "gross_carbon_removed_kg": 123,
    "losses_kg": 123,
    "net_carbon_removed_kg": 123
  },
  "ccp_approved": true,
  "country_of_issue": "GBR",
  "id": "ctb_1DRBTYA8Q1S07CBY",
  "issuance_id": "iss_1EWT8R5FY1S0GFCY",
  "issued_at": "2023-11-07T05:31:56Z",
  "left_child_id": "ctb_1DRBTYA8Q1S07CBY",
  "owner": {
    "domain": "isometric.com",
    "id": "org_1GB56M1ST1S0GVNA",
    "name": "Isometric"
  },
  "parent_id": "ctb_1DRBTYA8Q1S07CBY",
  "project_id": "prj_1CTWZQGKE1S0VAXA",
  "removal_id": "rmv_1EEM6NJXX1S0EXKD",
  "removal_location": {
    "country_code": "<string>",
    "country_name": "<string>"
  },
  "retired_at": "2023-11-07T05:31:56Z",
  "retirement_id": "ret_1FYBH4QDT1S0SVKF",
  "right_child_id": "ctb_1DRBTYA8Q1S07CBY",
  "sequestered_on": "2023-12-25",
  "serial_number": "ISO-1-BSTORE-GBR-F5X7-2024-78177-81177",
  "size": {
    "credit_kgs": 125632,
    "credits": 125.632
  },
  "status": "active",
  "supplier_id": "spl_1CC712KFS1S0YKPS"
}

Authorizations

​
Authorization
string
header
required

A JWT Bearer token header for authentication and authorization, in the format Authorization: Bearer <token>

Headers

​
x-client-secret
string
required

A secret token identifying the client connecting to the API

Example:

"Syou3EZiO5vuMEgNyBeA8cjEMYOnQDwP"

Path Parameters

​
id
string
required

Response

200
application/json
Successful Response
​
beneficiary
object | null
required
​
carbon_removal_data
object | null
required

Carbon removal data for this credit batch

​
ccp_approved
boolean
required

Whether this credit batch has been issued as part of a ICVCM Core Carbon Principles (CCP) approved project

​
country_of_issue
string
required
Required string length: 3
Example:

"GBR"

​
id
string
required
Required string length: 20 - 36
Example:

"ctb_1DRBTYA8Q1S07CBY"

​
issuance_id
string
required
Required string length: 20 - 36
Example:

"iss_1EWT8R5FY1S0GFCY"

​
issued_at
string
required
​
left_child_id
string | null
required

If this credit batch has status SPLIT, it will have two child batches representing the two halves of this split.

Required string length: 20 - 36
Example:

"ctb_1DRBTYA8Q1S07CBY"

​
owner
object
required
​
parent_id
string | null
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.

Required string length: 20 - 36
Example:

"ctb_1DRBTYA8Q1S07CBY"

​
project_id
string
required
Required string length: 20 - 36
Example:

"prj_1CTWZQGKE1S0VAXA"

​
removal_id
string
required
Required string length: 20 - 36
Example:

"rmv_1EEM6NJXX1S0EXKD"

​
removal_location
object | null
required

The location of the facility where this carbon removal took place, if available

​
retired_at
string | null
required
​
retirement_id
string | null
required
Required string length: 20 - 36
Example:

"ret_1FYBH4QDT1S0SVKF"

​
right_child_id
string | null
required

If this credit batch has status SPLIT, it will have two child batches representing the two halves of this split.

Required string length: 20 - 36
Example:

"ctb_1DRBTYA8Q1S07CBY"

​
sequestered_on
string
required
​
serial_number
string
required
Example:

"ISO-1-BSTORE-GBR-F5X7-2024-78177-81177"

​
size
object
required
​
status
enum<string>
required
Available options:
active,
split,
retired
​
supplier_id
string
required
Required string length: 20 - 36
Example:

"spl_1CC712KFS1S0YKPS"

Was this page helpful?