Skip to main content

Discover Assets

Prerequisites

Following roles are needed to be able to perform steps described on this page:

  • TRADER_VIEWER
  • ASSET_VIEWER

See Authorization for more details about roles

note

The Trader's id is needed to perform the next steps. If needed, trader details can be fetched using GET /saleschannel-services/v1/traders. If you need to create a Trader, follow the documentation here Registering Trader.

The inventory of a trader can be found by calling​

List all listable assets for a trader
curl -X 'GET' "/saleschannel-services/v1/traders/{traderId}/inventory" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $BEARER"

Example of a successful response​

Array
volume
required
integer >= 1

The amount of assets in this bundle.

productionFacilityId
required
string non-empty

The production facility which created the assets in this bundle.

supplierId
required
string non-empty

The ID of the account holder which owned the production facility which created the assets in this bundle.

methodologyCode
required
string

The code of the methodology that was used to create this bundle.

issuingDate
required
string <date-time>

The date on which the assets in this bundle have been issued, or null if the date is unknown.

expirationDate
required
string or null <date-time>

The date on which the assets in this bundle will expire, or null for PRE-CORCs.

creditTypeId
required
string

The ID of the credit type of the assets in this bundle.

standard
required
string

The standard of the assets in this bundle.

countryCode
required
string

The country of the production facility where the asset was issued.

productionStartDate
required
string <date-time>

The start date that the emissions removal took place.

productionEndDate
required
string <date-time>

The end date that the emissions removal took place.

vintage
required
integer >= 0

The year that the emissions removal took place.

issuanceId
required
string

The ID of the issuance that created this bundle.

certificates
required
string or null

The certificate numbers of the assets in this bundle.

start
required
string^(?:[a-zA-Z\d-]+_)?\d+$

The ID of the first asset included in this bundle.

end
required
string^(?:[a-zA-Z\d-]+_)?\d+$

The ID of the last asset included in this bundle, inclusive.

[
  • {
    }
]
info

The Assets' expirationDate field is deprecated as CORCs no longer expire automatically after 5 years. See Puro.earth General Rules V3.1 - 01 June 2023 .