2025-01-24

2024-12-13

Homepage

Registry

Isometric Documentation

Get started

Support

Introduction

Standards

Authentication

FAIR Principles

Shapefiles

Rasters

LiDAR data

Key Registry Concepts

Issuance

A paginated list of all issuances in Isometric's registry.

Returned list of issuances will be sorted by most recently issued first.

Issuances

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.

Issuance Credit Batches

List of issuances for a given supplier.

Issuances are sorted by most recently created first.

Issuances by Supplier

Delivery

A paginated list of all deliveries on Isometric's registry.

Returned list of projects will be sorted by most recently delivered first.

Deliveries

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.

Delivery Credit Batches

List of deliveries for a given supplier.

Deliveries are sorted by most recently delivered first.

Deliveries by Supplier

Retirement

A paginated list of all retirements on Isometric's registry.

Returned list of retirements will be sorted by most recently delivered first.

Retirements

List of credit batches for a given retirement.

Retirement Credit Batches

Transfer

List of credit batches in a given transfer.

Transfer Credit Batches

The organisation currently authenticated.

Use this endpoint to get your organisation_id.

Supplier

Suppliers

Project

A paginated list of all project documents for the given project.

Returned list of documents will be sorted alphabetically by document name.

Project Documents

List of projects for a given supplier.

Projects are sorted by most recently created first.

Projects by Supplier

Information about active and retired credits owned by the given organisation.

Includes total balances as well as balances split by projects and suppliers.

Organisation Credit Balance

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.

Organisation Credit Batches

Order

A paginated list of all orders placed by the organisation, sorted by descending placement date.

Organisation Orders

List of deliveries for a given order.

Deliveries are sorted by most recently delivered first.

Deliveries by Order

A paginated list of Organisations which the currently authenticated organisation can retire credits on the behalf of, using the `POST /retirements` endpoint.

Beneficiaries

Create a new beneficiary for your organisation to retire on behalf of.

Create Beneficiary

Retire credits from specific batches, in whole or with splits. All credit batches must originate from the same supplier and be owned by the current organisation.

Create Retirement

Retire oldest available credits from a given supplier. If vintage is specified, this will retire the oldest credits from that vintage only.

Create Retirement From Oldest Credits

A paginated list of Organisations which the currently authenticated organisation can transfer active credits to, using the `POST /transfers` endpoint.

Transferees

Transfer credits from specific batches, in whole or with splits. All credit batches must originate from the same supplier and be owned by the current organisation.

Create Transfer

The supplier currently authenticated.

Use this endpoint to get your supplier_id and organisation_id.

Current Supplier

List of orders for a given supplier.

Orders are sorted by most recently placed first.

Supplier Orders

Create Delivery

Key MRV Concepts

Component Blueprints

Attributing Components

Attributing components

Creating Your First Removal

Creating your first removal

Supplier Reference ID

Modifying Resources

Modifying resources

Get Sources

Get Source

Returns a short-lived signed URL for a source's private URL. This query will fail if
the source does not have a private URL or if the authenticated user does not have
access to it. That's why you need to first check the urlInfo field on the source
object, to ensure that you can safely use this query.

Get Source Private Url

Recreates a presigned upload URL, which must be used to upload the documentation
associated with this source. If the document is already uploaded, this endpoint will
response with a 409 error.

Post Signed Upload Url

Creates a source in the Isometric system. The client is provided with a presigned
upload URL which must be used to upload the document associated with this source.
Source documents are private, but other fields will be visible publicly once
credits are issued for an associated removal, moving it to the public registry.

Post Source

Patches metadata associated with a source in the Isometric system.

Patch Source

Deletes a source in the Isometric system. This is irreversible and the source cannot be recovered.

Delete Source

Get Datapoints

Returns a single datapoint in the Isometric system

Get Datapoint

Creates a datapoint in the Isometric system

Post Datapoint

Updates a datapoint in the Isometric system. Associated components and removals will be recalculated, if they are not in an immutable state.

Patch Datapoint

Delete a datapoint resource. Will fail if the datapoint is in use by a component.

Delete Datapoint

Lists component blueprints in the Isometric system

Get Component Blueprints

Get Components

Get a single component in the Isometric system

Get Component

Creates a component in the Isometric system

Post Component

Creates a component that will be automatically and evenly attributed to all removals with the GHG Statement.

Post Ghg Statement Component

Creates a component that will be automatically attributed to GHG statements in the project based on the provided amortization strategy.

Post Project Component

Manually attributes or removes attribution of a project component to a removal.

Post Project Component Removal Attribution

Removes all attribution of a project component to a removal.

Delete Project Component Removal Attribution

Creates a component in the Isometric system. Associated removals will be recalculated, if they are not in an immutable state.

Patch Component

Delete a component resource. Will fail if the component is in use by a verified removal.

Delete Component

Get Removals

Get Removal

Post Removal

Updates a removal in the Isometric system. The removal will be recalculated, if it is are not in an immutable state.

Patch Removal

This endpoint deletes a removal - this is irreversible and the removal cannot be recovered.

It will return an error if the removal is not in DRAFT status.

Delete Removal

Lists feedstock types in the Isometric system.

Get Feedstock Types

Get a single feedstock type in the Isometric system

Get Feedstock Type

Creates a feedstock type in the Isometric system

Post Feedstock Type

Updates a feedstock type in the Isometric system.

Patch Feedstock Type

Deletes a feedstock type in the Isometric system

Delete Feedstock Type

Lists GHG statements in the Isometric system

Get Ghg Statements

Get Ghg Statement

Submits a series of removals for verification

Post Ghg Statement

Post Ghg Statement Submit

Get a single measurement location in the Isometric system

Get Measurement Location

Lists measurement locations in the Isometric system

Get Measurement Locations

Post Measurement Locations

Deletes a measurement location in the Isometric system

Delete Measurement Location

Lists all monitoring requirements for a project.

Get Project Monitoring Requirements

Lists all monitoring submissions for a project monitoring requirement

Get Monitoring Submissions

Creates a monitoring submission for a project monitoring requirement.

The submission is associated with a previously uploaded source document (see [Post Source](/mrv/post-source)).
One source may be used to create multiple submissions.

Post Monitoring Submission

Deletes a monitoring submission for a project monitoring requirement

MRV Overview

MRV Data

Organisation Data

Changelog