Certify
- Getting started
- Project and supplier data
- Carbon accounting
- API changelog
Registry
- Getting Started
- Public registry data
- Issuances
- Deliveries
- Retirements
- Transfers
- Suppliers
- Projects
- Buyer account management
- Supplier account management
- API changelog
Issuance 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.
curl --request GET \
--url https://api.sandbox.isometric.com/registry/v0/issuances/{id}/credit_batches \
--header 'Authorization: Bearer <token>' \
--header 'x-client-secret: <x-client-secret>'{
"buffer_pool_credit_batch_size_total": {
"credit_kgs": 125632,
"credits": 125.632
},
"buffer_pool_credit_batches": [
{
"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"
}
],
"credit_batch_size_total": {
"credit_kgs": 125632,
"credits": 125.632
},
"issuance_id": "iss_1EWT8R5FY1S0GFCY",
"supplier_credit_batch_size_total": {
"credit_kgs": 125632,
"credits": 125.632
},
"supplier_credit_batches": [
{
"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
A JWT Bearer token header for authentication and authorization, in the format Authorization: Bearer <token>
Headers
A secret token identifying the client connecting to the API
"Syou3EZiO5vuMEgNyBeA8cjEMYOnQDwP"
Path Parameters
Response
A representation of the credit quantity as an integer kilogram amount. Where 1 unit represents 0.001 credits and 1 kilogram of CO₂e.
125632
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.
125.632
Carbon removal data for this credit batch
Whether this credit batch has been issued as part of a ICVCM Core Carbon Principles (CCP) approved project
3"GBR"
20 - 36"ctb_1DRBTYA8Q1S07CBY"
20 - 36"iss_1EWT8R5FY1S0GFCY"
If this credit batch has status SPLIT, it will have two child batches representing the two halves of this split.
20 - 36"ctb_1DRBTYA8Q1S07CBY"
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.
20 - 36"ctb_1DRBTYA8Q1S07CBY"
20 - 36"prj_1CTWZQGKE1S0VAXA"
20 - 36"rmv_1EEM6NJXX1S0EXKD"
20 - 36"ret_1FYBH4QDT1S0SVKF"
If this credit batch has status SPLIT, it will have two child batches representing the two halves of this split.
20 - 36"ctb_1DRBTYA8Q1S07CBY"
"ISO-1-BSTORE-GBR-F5X7-2024-78177-81177"
A representation of the credit quantity as an integer kilogram amount. Where 1 unit represents 0.001 credits and 1 kilogram of CO₂e.
125632
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.
125.632
active, split, retired 20 - 36"spl_1CC712KFS1S0YKPS"
A representation of the credit quantity as an integer kilogram amount. Where 1 unit represents 0.001 credits and 1 kilogram of CO₂e.
125632
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.
125.632
20 - 36"iss_1EWT8R5FY1S0GFCY"
A representation of the credit quantity as an integer kilogram amount. Where 1 unit represents 0.001 credits and 1 kilogram of CO₂e.
125632
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.
125.632
Carbon removal data for this credit batch
Whether this credit batch has been issued as part of a ICVCM Core Carbon Principles (CCP) approved project
3"GBR"
20 - 36"ctb_1DRBTYA8Q1S07CBY"
20 - 36"iss_1EWT8R5FY1S0GFCY"
If this credit batch has status SPLIT, it will have two child batches representing the two halves of this split.
20 - 36"ctb_1DRBTYA8Q1S07CBY"
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.
20 - 36"ctb_1DRBTYA8Q1S07CBY"
20 - 36"prj_1CTWZQGKE1S0VAXA"
20 - 36"rmv_1EEM6NJXX1S0EXKD"
20 - 36"ret_1FYBH4QDT1S0SVKF"
If this credit batch has status SPLIT, it will have two child batches representing the two halves of this split.
20 - 36"ctb_1DRBTYA8Q1S07CBY"
"ISO-1-BSTORE-GBR-F5X7-2024-78177-81177"
A representation of the credit quantity as an integer kilogram amount. Where 1 unit represents 0.001 credits and 1 kilogram of CO₂e.
125632
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.
125.632
active, split, retired 20 - 36"spl_1CC712KFS1S0YKPS"
Was this page helpful?
curl --request GET \
--url https://api.sandbox.isometric.com/registry/v0/issuances/{id}/credit_batches \
--header 'Authorization: Bearer <token>' \
--header 'x-client-secret: <x-client-secret>'{
"buffer_pool_credit_batch_size_total": {
"credit_kgs": 125632,
"credits": 125.632
},
"buffer_pool_credit_batches": [
{
"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"
}
],
"credit_batch_size_total": {
"credit_kgs": 125632,
"credits": 125.632
},
"issuance_id": "iss_1EWT8R5FY1S0GFCY",
"supplier_credit_batch_size_total": {
"credit_kgs": 125632,
"credits": 125.632
},
"supplier_credit_batches": [
{
"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"
}
]
}