Backoffice Admin API
{id}
{id}
/carbon{id}
/collections{id}
/creatures{id}
/offersList of all projects across multiple organisations
Request parameters
Responses
OK
Body
The account that is aggregating the projects
The Beneficial Owner of the Project
69de6a72-2797-11ed-b110-42010a9a0008
Carbon Streaming
Carbon Streaming owner of multiple projects
Details of Carbon Blocks
ID of the carbon inventory
Carbon Inventory Name
Vintage of carbon
Prices for Carbon
Block Numbers for given carbon
ID of usage type
HERO
GET /projects HTTP/1.1
HTTP/1.1 200 OK
Content-Type: application/json
{
"content": [
{
"id": "69de6a72-2797-11ed-b110-42010a9a0008",
"name": "Kariba REDD+ Project",
"description": "The Kariba REDD+ Project will generate approximately 196,500,000 carbon credits from reduced emissions associated with deforestation over 30 years. The reduction in deforestation “will be achieved through a series of activities that are designed to significantly improve the livelihoods of locals",
"account": {
"id": "",
"name": "",
"description": ""
},
"owner": {
"id": "",
"name": "",
"description": ""
},
"carbon": [
{
"id": "",
"name": "",
"vintage": {
"from_date": "",
"to_date": ""
},
"unit_type": "VCU",
"costs": {
"unit_cost": 1
},
"pricing": [
{
"id": "95ac16e3-c194-11ec-a97e-42010a9a0008",
"name": "Island Innovation NFT",
"price_model": "FLAT",
"sales_prices": [
{
"id": "38186aea-c18d-11ec-a97e-42010a9a0008",
"location_code": "UK",
"currency": "USDC",
"display_price": "$40.00",
"effective_date": 1650557281,
"price": 40,
"tax_model": "INCLUSIVE"
}
]
}
],
"block": {
"start_block": 1,
"end_block": 1,
"total_blocks": 1
}
}
],
"creatives": [
{
"id": "0e02f4ab-797c-405c-8bf7-14651e28fe05",
"usage_type": {
"id": "",
"name": ""
},
"width": 259,
"format": "jpg",
"media": {
"id": ""
},
"medias": [
{
"width": 50,
"height": 37,
"url": "https://res.cloudinary.com/image/upload/c_scale,f_auto,q_auto,w_50/v1/bg/v6z5d9dq7wktaqmm5nbm.jpg"
}
],
"url": "https://res.cloudinary.com/vizulink-tech-lmimited/image/upload/v1/bg/v6z5d9dq7wktaqmm5nbm.jpg",
"height": 194,
"media_group": {
"id": "",
"name": ""
},
"public_id": "bg/v6z5d9dq7wktaqmm5nbm"
}
],
"location": {
"geo": {
"lat": "",
"lon": ""
},
"continent": "",
"country": "",
"region": ""
}
}
],
"paging": {
"page_number": 1,
"page_size": 10
},
"total_elements": 4,
"total_pages": 1
}
{id}
Path variables
Responses
OK
Body
69de6a72-2797-11ed-b110-42010a9a0008
Stand For Trees
{id}
/carbonPath variables
Responses
OK
Body
GET /projects/{id}/carbon HTTP/1.1
HTTP/1.1 200 OK
Content-Type: application/json
[
{
"id": "",
"name": "",
"vintage": {
"vintage": "2014 - 2016",
"vintage_from": 1,
"vintage_to": 1
},
"unit_type": "VCU",
"purchase_date": 1,
"carbon": {
"open_balance": 1,
"current_balance": 1
},
"costs": {
"purchase_price": 1,
"currency": "USD"
},
"serial_number": "",
"supplier": {
"id": "",
"name": ""
},
"consigned": {
"id": "",
"name": ""
},
"verifier_reference": ""
}
]
{id}
/collectionsPath variables
Responses
OK
Body
GET /projects/{id}/collections HTTP/1.1
HTTP/1.1 200 OK
Content-Type: application/json
[
{
"id": "",
"name": "",
"base_url": "",
"contract": {
"address": "",
"abi": "",
"is_mc": "",
"blockchain": {
"network": ""
}
},
"attributes": [
{
"id": "",
"nft_type": "MERCHANDISE",
"name": "rarity",
"description": "",
"attribute_value": "Critically Endangered",
"lexicon": "nft.rarity",
"iso639-2": "eng",
"attribute_type": "NUMERIC"
}
]
}
]
{id}
/creaturesPath variables
Responses
Body
{id}
/retirements{id}
/retirementsGets a list of retirements recorded in MC dbms and the certificates from the IHS or VERA registry
Request parameters
List of Project ID’s for filter
Start Date for filter
Ed Date for filter
Request headers
Used for Server to Server API
Responses
OK
Body
Registry serial number
guid of additional certifications
Verra
Kilogram Units to support Fractional
GET /retirements HTTP/1.1
HTTP/1.1 200 OK
Content-Type: application/json
{
"content": [
{
"id": "69de6a72-2797-11ed-b110-42010a9a0008",
"retirement_date": 1,
"serial_number": "5570-246363874-246363878-VCU-024-MER-PE-14-985-08082013-07082014-1",
"carbon_inventory": {
"id": "",
"name": "",
"vintage": {
"vintage": "2014 - 2016",
"vintage_from": 1,
"vintage_to": 1
},
"unit_type": "VCU",
"purchase_date": 1,
"costs": {
"purchase_price": 1,
"currency": "USD"
},
"blocks": 1,
"serial_number": "",
"supplier": {
"id": "",
"name": ""
},
"verifier_reference": ""
},
"project": {
"id": "",
"name": "",
"description": ""
},
"account": {
"id": "",
"name": "",
"description": ""
},
"beneficiary": {
"id": "",
"name": "",
"description": ""
},
"certifcations": [
{
"id": "",
"name": "CCB-Gold"
}
],
"reason": {
"id": "",
"name": "",
"description": ""
},
"registry": [
{
"id": "VERRA",
"name": ""
}
],
"financials": [
{
"id": "",
"financial_type": "COST",
"wallet": 154.5,
"amount": 15.45,
"is_conversion": true,
"currency_code": "",
"rate": 144.5
}
]
}
],
"paging": {
"page_number": 1,
"page_size": 10
},
"total_elements": 4,
"total_pages": 1
}
Gets a list of retirements recorded in MC dbms and the certificates from the IHS or VERA registry
Request body
Optional ID if not provided a system generated ID will be created
{id}
/products{id}
/templates{id}
/schemas{id}
/attributesResponses
Body
Examples
[
{
"id": "",
"display_name": "",
"name": "",
"description": "",
"market_fee": 1
}
]
Responses
Body
Examples
{
"id": "",
"name": "",
"description": "",
"long_description": "",
"market_fee": 1,
"display_name": "",
"website_url": "",
"socials": {
"facebook_url": "",
"twitter_url": "",
"medium_url": "",
"github_url": "",
"discord_url": "",
"telegram_url": "",
"youtube_url": ""
},
"taxon": "",
"image": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"video": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"background_image": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"integration": {
"id": "",
"name": "",
"icon": {
"active": "",
"in-active": ""
}
}
}
{id}
/productsGet a list of the links to a collection product and linked creature
Path variables
Responses
OK
Body
{id}
/templatesList of templates with the default values
Path variables
Responses
default response
Body
Examples
{
"id": "637991",
"name": "Mountain Gorilla - Bronze",
"description": "Mountain gorillas live at high elevation over 8,000 feet in the mountains of the Congo, Rwanda and Uganda. Their thick fur helps keep them warm in temperatures which often drop below freezing. Despite these conditions, Mountain Gorillas have fought extinction and recently their numbers have even increased but now, a new challenge awaits. The Mountain Gorilla is in danger and needs your help! Offset more carbon to support the Gorilla and other endangered creatures. ",
"is_transferable": true,
"is_burnable": true,
"max_supply": 1,
"issued_supply": 94,
"image": {
"id": null,
"type": "PHOTO",
"width": null,
"height": null,
"format": "IPFS",
"url": "https://ipfs.io/ipfs/QmUw4ZXmvGyEbyv1r5m3wsLtbrmKx6npKuY6sSmViwbcnp",
"thumbnail_url": null,
"public_id": "QmUw4ZXmvGyEbyv1r5m3wsLtbrmKx6npKuY6sSmViwbcnp",
"media": [
{
"width": 1,
"height": 1,
"url": "https://ipfs.io/ipfs/QmUw4ZXmvGyEbyv1r5m3wsLtbrmKx6npKuY6sSmViwbcnp"
}
],
"created_on": null,
"media_external_id": null,
"media_group_external_id": null
},
"video": null,
"back_image": null,
"back_video": null
}
{id}
/schemasGet a list of schema’s for a given collection
Path variables
Request body
{id}
/attributesPath variables
Responses
Body
Name of Atttribute
Lexicon to match / replace from an event body
Type of atribute simplifed
Examples
[
{
"id": "",
"name": "CO2 Offset Amount (kg)",
"lexicon": "nft.carbon.co2_offset",
"attribute_type": "URI"
}
]
{id}
/wallets{id}
/nfts{id}
/transactions{id}
/wallets{id}
/projects{id}
/projects{id}
/transactionsPath variables
Request body
date of transaction
reference number
Kilogram Units of Carbon
Request body
POST /transactions HTTP/1.1
Content-Type: application/json
{
"transaction_date": 1,
"reference": "",
"base_currency": {
"currency": "USD",
"amount": "1234.56"
},
"source_currency": {
"currency": "WAXP",
"amount": 1
},
"wallet": {
"wallet_address": "",
"id": ""
},
"contact": {
"id": ""
}
}
{id}
/walletsPath variables
Request body
Wallet ID if internal
Wallet address wil be used for lookup
POST /projects/{id}/wallets HTTP/1.1
Content-Type: application/json
[
{
"wallet": {
"id": "",
"wallet_address": ""
},
"priority": "",
"wallet_role": "REVENUE"
}
]
{id}
/projectsList of Wallets connected to a Projects, to use for fund distribution, and tracking
Path variables
Responses
Body
NFT are created based on a Product in the case of merchandising, or simply represetn a certifiction such as a retirement certificate
{id}
{id}
/nfs{id}
/retirements{id}
/attributes{id}
/retirement{id}
Request parameters
List of collection ID
date ranges use dot notation for different params created.from created.before
Type of NFT
Ensure that the list of nft’s is returned in tier priority order
Responses
OK
Body
Examples
[
{
"id": "",
"name": "",
"description": "",
"nft_type": "",
"created_date": "",
"image": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"video": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"is_ipfs": true,
"is_fractional": true,
"is_transferable": true,
"rank": 1,
"series": {
"issue": "",
"total": ""
},
"lifecycle": "RANKED",
"campaign": {
"id": "",
"name": "",
"description": ""
},
"tier": {
"id": "",
"name": "",
"description": "",
"rank_min": "",
"rank_max": "",
"color_code": "",
"priority": 1
},
"template": {
"id": "",
"name": "",
"description": ""
},
"collection": {
"id": "",
"name": "",
"description": ""
},
"blockchains": [
{
"id": "",
"minted_date": "",
"platform": "",
"token": {
"id": "",
"token_type": ""
}
}
],
"owners": [
{
"id": "",
"wallet_id": "0x0fca20275697de6ebff30a293b3ceb21c003e972",
"organisation": {
"id": "",
"name": ""
},
"contact": {
"id": "",
"name": ""
},
"ownership_start": 1,
"ownership_end": 1,
"percentage": 100
}
]
}
]
{id}
Path variables
Responses
default response
Body
GET /nfts/{id} HTTP/1.1
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": "",
"name": "",
"description": "",
"nft_type": "MERCHANDISE",
"is_fractional": "",
"is_transferable": "",
"image_id": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"video_id": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"lifecycle": "MINTED",
"series_number": "",
"total_in_series": "",
"is_ipfs": "",
"created_date": "",
"tier": {
"id": "",
"name": ""
},
"co2_offset_amount": 1,
"retirement": {
"id": ""
},
"template": {
"id": "",
"name": ""
},
"collection": {
"id": "",
"name": ""
},
"blockchain": {
"id": "",
"token": "",
"token_type": "",
"platform": "",
"minted_date": ""
},
"owner": [
{
"id": "",
"contact_id": "",
"organisation_id": "",
"given_name": "",
"percentage": 1,
"ownership_start": "",
"ownership_end": "",
"wallet": {
"id": "",
"alias": "",
"wallet_address": "",
"tenant_id": ""
}
}
]
}
{id}
/nfsGet a list of NFT’s for a collection
Path variables
Request parameters
List of nft_types
Responses
OK
Body
{id}
/attributesList of attributes for an NFT, extracted from the Product Catalog
Path variables
Responses
Body
GET /nfts/{id}/attributes HTTP/1.1
HTTP/1.1 200 OK
Content-Type: application/json
[
{
"id": "",
"name": "",
"description": "",
"attribute_value": "Critically Endangered",
"iso639-2": "eng"
}
]
Request parameters
List of collection ID
date ranges use dot notation for different params created.from created.before
Type of NFT
Responses
OK
Body
Type of nft Merchandise or Retirement
NFT originating product from catalog.
If the product originated from an external source such as Shopify
guid
Original Product Name
Original product Description
Family from product Catalog
Brand from Product Catalog
date of minting
wallet
Contact Details Name or alias if linked
Contacts name or alias
Date ownership was assigned
Date ownership was ended if transfered.
GET /nfts HTTP/1.1
HTTP/1.1 200 OK
Content-Type: application/json
{
"content": [
{
"id": "e28afa4d-c18b-11ec-a97e-42010a9a0008",
"name": "Fred Island NFT",
"description": "There are 10,000 Island Innovation Impact NFTs and each represents 1 seedling being planted by Fundacion Groupo Social. 70% of the money is spent buying and planting seedlings, 15% supports Island Innovation and 15% supports Meta Carbon Inc.",
"nft_type": "RETIREMENT",
"creatives": [
{
"id": "0e02f4ab-797c-405c-8bf7-14651e28fe05",
"usage_type": null,
"width": 259,
"format": "jpg",
"media_id": "",
"media": [
{
"width": 50,
"height": 37,
"url": "https://res.cloudinary.com/image/upload/c_scale,f_auto,q_auto,w_50/v1/bg/v6z5d9dq7wktaqmm5nbm.jpg"
}
],
"url": "https://res.cloudinary.com/vizulink-tech-lmimited/image/upload/v1/bg/v6z5d9dq7wktaqmm5nbm.jpg",
"height": 194,
"media_group_id": null,
"public_id": "bg/v6z5d9dq7wktaqmm5nbm"
}
],
"product": {
"integration": {
"id": "",
"name": "",
"sku": ""
},
"id": "",
"name": "Island NFT",
"description": "There are 10,000 Island Innovation Impact NFTs and each represents 1 seedling being planted by Fundacion Groupo Social. 70% of the money is spent buying and planting seedlings, 15% supports Island Innovation and 15% supports Meta Carbon Inc.",
"sku": "",
"family": "Island Innovation",
"brand": ""
},
"blockchain": {
"token": {
"id": "",
"hash": "",
"uri": ""
},
"platform": "WAX",
"minted_date": ""
},
"collection": {
"id": "",
"name": ""
},
"owners": [
{
"id": "",
"wallet_id": "",
"contact": {
"id": "",
"name": ""
},
"ownership_start": 1,
"ownwership_end": ""
}
]
}
],
"paging": {
"page_number": 1,
"page_size": 10
},
"total_elements": 7,
"total_pages": 1
}
{id}
/retirementPath variables
Responses
Body
Examples
{
"id": "",
"details": "",
"offset_url": "",
"co2_offset_amount": "",
"unit_type": "",
"retirement_date": "",
"is_pending": "",
"serial_number": "",
"project": {
"id": "",
"name": "",
"image": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
}
},
"inventory": {
"id": "",
"serial_number": ""
},
"beneficiary": {
"id": "",
"name": ""
},
"account": {
"id": "",
"name": ""
},
"retirement_reason": {
"id": "",
"name": "",
"description": ""
},
"registry": {
"id": "",
"name": "",
"description": ""
}
}
{id}
Path variables
Responses
default response
Body
Rank from NFT
GET /nfts/{id} HTTP/1.1
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": "dc7ac2af-d65f-4261-832b-e08193b354d2",
"name": "Elephant Bronze",
"description": "Elephant Bronze: Atomic Hub Feb 2023",
"nft_type": "MERCHANDISE",
"image": {
"id": null,
"type": "PHOTO",
"width": null,
"height": null,
"format": "IPFS",
"url": "https://ipfs.io/ipfs/Qmd9ZGZXPLW2GortTYAAMNB4wJJn8Ypt1ZWrv175qhBcGN",
"thumbnail_url": null,
"public_id": "Qmd9ZGZXPLW2GortTYAAMNB4wJJn8Ypt1ZWrv175qhBcGN",
"media": [
{
"width": 1,
"height": 1,
"url": "https://ipfs.io/ipfs/Qmd9ZGZXPLW2GortTYAAMNB4wJJn8Ypt1ZWrv175qhBcGN"
}
],
"created_on": null,
"media_external_id": null,
"media_group_external_id": null
},
"video": null,
"collection": {
"id": "c582e699-3a6a-11ed-adf6-42010a9a000c",
"name": "Meta Carbon Offset"
},
"owner": {
"id": "1d3f9cc6-70c7-42f3-919d-5e0faf3c860f",
"wallet": {
"id": "1e5af15c-dd93-405d-b21a-50b29cda0da5",
"alias": null,
"wallet_address": "k.ovq.wam"
},
"organisation": {
"id": null,
"name": null
},
"contact": {
"id": null,
"name": null
},
"ownwership_end": 1,
"ownership_start": 1678122335
},
"series": {
"issue": 34,
"total": 1,
"rank": 1
},
"lifecycle": "MINTED",
"tier": {
"id": "bde672f3-76d2-11ed-a040-42010a9a0003",
"name": "Bronze",
"color_code": "#D2C7C7"
},
"blockchain": [
{
"id": "d0f0278c-3915-418c-9295-f59e5153ced0",
"token": {
"id": "1099552529997",
"token_type": "WAX"
},
"platform": "WAX",
"minted_date": 1678122380
}
],
"carbon": [
{
"id": "f76b05fa-1d6e-4040-a3c3-87e636b83cf1",
"retirement_date": "2023-03-06T17:02:55Z",
"serial_number": "12787-437759053-437759075-VCS-VCU-259-VER-CD-14-934-01012017-31122017-1",
"carbon_inventory": {
"id": "9d8e3ad7-65c3-11ed-885d-42010a9a0002",
"vintage": {
"name": "2017",
"vintage_from": "2017",
"vintage_to": "2017"
},
"unit_type": null,
"purchase_date": 1667520000,
"carbon": {
"open_balance": 5000,
"current_balance": 5000
},
"serial_number": "12787-437519438-437524437-VCS-VCU-259-VER-CD-14-934-01012017-31122017-1",
"supplier": {
"id": "0a1029ba-65c1-11ed-885d-42010a9a0002"
},
"consigned": {},
"verifier_reference": null,
"registry": {
"id": "36ca5da6-6c0b-11ed-aec0-42010a9a0004",
"name": "VERRA"
}
},
"account": {
"name": "Meta Carbon",
"id": "841d528d-3112-11ed-adf6-42010a9a000c"
},
"beneficiary": {
"name": "Atomic Hub",
"id": "87ed427e-3a64-11ed-adf6-42010a9a000c"
},
"certifications": null,
"reason": {
"id": "ec502490-3f14-11ed-adf6-42010a9a000a",
"name": "Carbon Offset",
"description": "Carbon Offset"
},
"registry": {
"id": "36ca5da6-6c0b-11ed-aec0-42010a9a0004",
"name": "VERRA"
},
"unit_type": "VCU",
"project": {
"id": "6015c543-4ed8-11ed-aec0-42010a9a0004",
"name": "Mai Ndombe",
"description": "Help this project protect over 250,000 hectares of critical bonobo and forest elephant habitat and provide drinking water, education, healthcare, and food security to 30,000 locals."
},
"financials": [
null
],
"offset_url": "https://registry.verra.org/myModule/rpt/myrpt.asp?r=206&h=190672",
"units": 1000,
"merchandise": {
"units": 1
}
}
]
}
Rules for merchandiding to support ranking etc
Request parameters
Meta-carbon supports its own Product Catlog to allow Digital Goods such as NFT’s like a creature to be specified inlcuding all the variants and prices. These Products can then be used to apply attributes to an NFT, Creature Type, Colour, Gender, Endangered status.
If required then third party catalogs can be used, suc h as Shopify or other eCommerce platforms.
Request parameters
Type of Products
Responses
OK
Body
GET /products HTTP/1.1
HTTP/1.1 200 OK
Content-Type: application/json
{
"content": [
{
"id": "e28afa4d-c18b-11ec-a97e-42010a9a0008",
"created_on": 1650556708,
"name": "Island Innovation NFT",
"description": "There are 10,000 Island Innovation Impact NFTs and each represents 1 seedling being planted by Fundacion Groupo Social. 70% of the money is spent buying and planting seedlings, 15% supports Island Innovation and 15% supports Meta Carbon Inc.",
"business_type": "NFT",
"product_type": "NFT",
"product_class": "DIGITAL",
"sold_as": "SERIES",
"tenant_id": "0eafff17-c290-44ed-8556-f142533fb251",
"sku": "II-NFT-01",
"series_count": 10000,
"families": [
{
"id": "18b13e22-c18c-11ec-a97e-42010a9a0008",
"name": "Island Innovation",
"description": "Connecting Islands for Positive Change"
}
],
"brands": [
{
"id": "8ae09b0c-c18c-11ec-a97e-42010a9a0008",
"name": "Island Innovation",
"description": "Island Innovation"
}
],
"pricing": [
{
"id": "95ac16e3-c194-11ec-a97e-42010a9a0008",
"name": "Island Innovation NFT",
"prices": [
{
"id": "38186aea-c18d-11ec-a97e-42010a9a0008",
"name": "II-NFT-BASE",
"location_code": "UK",
"currency": "USD",
"display_price": "$40.00",
"effective_date": 1650557281,
"during_binding": true,
"price": 40,
"tax_model": "INCLUSIVE"
}
],
"payment_model": "PREPAY",
"price_model": "FLAT",
"price_type": "ONE_OFF",
"primary": true
}
],
"features": [
null
],
"filters": [
null
],
"creatives": [
{
"id": "0e02f4ab-797c-405c-8bf7-14651e28fe05",
"usage_type": null,
"width": 259,
"format": "jpg",
"media_id": null,
"media": [
{
"width": 50,
"height": 37,
"url": "https://res.cloudinary.com/image/upload/c_scale,f_auto,q_auto,w_50/v1/bg/v6z5d9dq7wktaqmm5nbm.jpg"
}
],
"url": "https://res.cloudinary.com/vizulink-tech-lmimited/image/upload/v1/bg/v6z5d9dq7wktaqmm5nbm.jpg",
"height": 194,
"media_group": {
"id": "",
"name": ""
},
"public_id": "bg/v6z5d9dq7wktaqmm5nbm"
}
]
}
],
"paging": {
"page_number": 1,
"page_size": 10
},
"total_elements": 7,
"total_pages": 1
}
[
{
"id": "",
"name": "",
"description": "",
"attributes": [
{
"id": "",
"attribute_name": "",
"attribute_type": "",
"lexicon": ""
}
]
}
]
{
"id": "",
"name": "CO2 Offset Amount (kg)",
"lexicon": "nft.carbon.co2_offset",
"attribute_type": "URI"
}
[
{
"id": "",
"name": "",
"description": "",
"is_transferable": true,
"is_burnable": true,
"max_supply": 1,
"image": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"video": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"back_image": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"back_video": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"issued_supply": 1,
"is_ipfs": true,
"schema": {
"id": "",
"name": ""
}
}
]
{
"id": "",
"name": "",
"description": "",
"is_transferable": true,
"is_burnable": "",
"max_supply": 1,
"image": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"back_image": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"video": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"back_video": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"issued_supply": "",
"schema_id": {
"id": "",
"name": "",
"description": ""
},
"is_ipfs": true
}
{
"id": "e28afa4d-c18b-11ec-a97e-42010a9a0008",
"name": "Fred Island NFT",
"description": "There are 10,000 Island Innovation Impact NFTs and each represents 1 seedling being planted by Fundacion Groupo Social. 70% of the money is spent buying and planting seedlings, 15% supports Island Innovation and 15% supports Meta Carbon Inc.",
"nft_type": "RETIREMENT",
"image": {
"id": "0e02f4ab-797c-405c-8bf7-14651e28fe05",
"usage_type": null,
"width": 259,
"format": "jpg",
"media_id": null,
"media": [
{
"width": 50,
"height": 37,
"url": "https://res.cloudinary.com/image/upload/c_scale,f_auto,q_auto,w_50/v1/bg/v6z5d9dq7wktaqmm5nbm.jpg"
}
],
"url": "https://res.cloudinary.com/vizulink-tech-lmimited/image/upload/v1/bg/v6z5d9dq7wktaqmm5nbm.jpg",
"height": 194,
"media_group": {
"id": "",
"name": ""
},
"public_id": "bg/v6z5d9dq7wktaqmm5nbm"
},
"video": {
"id": "0e02f4ab-797c-405c-8bf7-14651e28fe05",
"usage_type": null,
"width": 259,
"format": "jpg",
"media_id": null,
"media": [
{
"width": 50,
"height": 37,
"url": "https://res.cloudinary.com/image/upload/c_scale,f_auto,q_auto,w_50/v1/bg/v6z5d9dq7wktaqmm5nbm.jpg"
}
],
"url": "https://res.cloudinary.com/vizulink-tech-lmimited/image/upload/v1/bg/v6z5d9dq7wktaqmm5nbm.jpg",
"height": 194,
"media_group": {
"id": "",
"name": ""
},
"public_id": "bg/v6z5d9dq7wktaqmm5nbm"
},
"blockchain": [
{
"token": {
"id": "",
"hash": "",
"uri": "",
"token_type": "ERC721"
},
"platform": "POLYGON",
"minted_date": ""
}
],
"collection": {
"id": "",
"name": ""
},
"owners": [
{
"id": "",
"wallet_id": "0x0fca20275697de6ebff30a293b3ceb21c003e972",
"organisation": {
"id": "",
"name": ""
},
"contact": {
"id": "",
"name": ""
},
"ownership_start": 1,
"ownership_end": 1,
"percentage": 100
}
],
"series": {
"issue": 232,
"total": 500
},
"organisations": [
{
"id": "",
"name": "",
"organisation_role": "SPONSOR"
}
],
"project": {
"id": "",
"name": "",
"description": "",
"location": {
"geo": {
"lat": 15.638126,
"lon": -88.822659
},
"continent": "Africa",
"country": "Sierra Leone",
"region": "",
"iso_": ""
},
"sdg_goals": [
{
"id": "",
"sdg_goal": 1,
"name": "",
"description": ""
}
],
"creatures": [
{
"id": "",
"name": "",
"description": "",
"iucn_status": "EXTINCT",
"iucn_url": ""
}
]
}
}
NFT lsit itm, used for lists, search filters
Ensure the latest owner based on date is object 0
[
{
"id": "",
"name": "",
"description": "",
"nft_type": "",
"created_date": "",
"image": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"video": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"is_ipfs": true,
"is_fractional": true,
"is_transferable": true,
"rank": 1,
"series": {
"issue": "",
"total": ""
},
"lifecycle": "RANKED",
"campaign": {
"id": "",
"name": "",
"description": ""
},
"tier": {
"id": "",
"name": "",
"description": "",
"rank_min": "",
"rank_max": "",
"color_code": "",
"priority": 1
},
"template": {
"id": "",
"name": "",
"description": ""
},
"collection": {
"id": "",
"name": "",
"description": ""
},
"blockchains": [
{
"id": "",
"minted_date": "",
"platform": "",
"token": {
"id": "",
"token_type": ""
}
}
],
"owners": [
{
"id": "",
"wallet_id": "0x0fca20275697de6ebff30a293b3ceb21c003e972",
"organisation": {
"id": "",
"name": ""
},
"contact": {
"id": "",
"name": ""
},
"ownership_start": 1,
"ownership_end": 1,
"percentage": 100
}
]
}
]
Atttrubutes for an NFT
Attribute name
How rare is the NFT
json supported element name
[
{
"id": "",
"name": "",
"description": "",
"long_description": "",
"market_fee": 1,
"display_name": "",
"website_url": "",
"socials": {
"facebook_url": "",
"twitter_url": "",
"medium_url": "",
"github_url": "",
"discord_url": "",
"telegram_url": "",
"youtube_url": ""
}
}
]
{
"id": "",
"name": "",
"description": "",
"long_description": "",
"market_fee": 1,
"display_name": "",
"website_url": "",
"socials": {
"facebook_url": "",
"twitter_url": "",
"medium_url": "",
"github_url": "",
"discord_url": "",
"telegram_url": "",
"youtube_url": ""
}
}
Generic Creatives Array
String form of vintage
2014
Simple Financials to record transctional cost and sales for multiple currency
Type of transaction amount Cost or Sale, with multiple sales reflecting differenct currencies for the same transaction
Total sales price based on number of units
amount of sale or cost in given currency.
USD
Total cost price of transction
Atttrubutes for an Collection used for defining the NFT
Attribute name
How rare is the NFT
json supported element name
Used to link the orginal product catalog item, that can be used as base properties for an NFT
Ownership object
Metadata templates for grouping schema attributes
Unique ID on external Platform
{id}
/projects{id}
/projects{id}
/projectsPath variables
Responses
Body
Examples
{
"id": "",
"name": "",
"description": "",
"start_date": "",
"end_date": "",
"account": "",
"collection": {
"id": "",
"name": ""
},
"blockchain_receiver": "",
"integration": {
"id": "",
"name": "",
"icon": ""
},
"receiver_wallet": {
"id": "",
"alias": "",
"wallet_address": ""
}
}
Request body
Responses
Body
Examples
{
"id": "",
"name": "",
"description": "",
"start_date": "",
"end_date": "",
"account": "",
"collection": {
"id": "",
"name": ""
},
"blockchain_receiver": "",
"integration": {
"id": "",
"name": "",
"icon": ""
},
"receiver_wallet": {
"id": "",
"alias": "",
"wallet_address": ""
}
}
{id}
/projectsPath variables
Responses
Body
Offset kilo amount from wallet transactions
GET /campaigns/{id}/projects HTTP/1.1
HTTP/1.1 200 OK
Content-Type: application/json
[
{
"id": "",
"co2_offset_kilos": "",
"project": {
"id": "",
"name": "",
"description": "",
"creatives": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
}
},
"template": {
"id": "",
"name": "",
"description": "",
"platform_id": "",
"image": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
}
},
"retirements": [
{
"id": "",
"retirement_date": "",
"serial_number": "",
"carbon": {
"retired_co2": "",
"merchandise_co2": "",
"nft": {
"id": "",
"name": "",
"image": {
"id": "0e02f4ab-797c-405c-8bf7-14651e28fe05",
"usage_type": null,
"width": 259,
"format": "jpg",
"media_id": null,
"media": [
{
"width": 50,
"height": 37,
"url": "https://res.cloudinary.com/image/upload/c_scale,f_auto,q_auto,w_50/v1/bg/v6z5d9dq7wktaqmm5nbm.jpg"
}
],
"url": "https://res.cloudinary.com/vizulink-tech-lmimited/image/upload/v1/bg/v6z5d9dq7wktaqmm5nbm.jpg",
"height": 194,
"media_group": {
"id": "",
"name": ""
},
"public_id": "bg/v6z5d9dq7wktaqmm5nbm"
}
}
}
}
]
}
]
Responses
Body
Examples
[
{
"id": "",
"name": "",
"description": "",
"is_transferable": true,
"is_burnable": "",
"supply": {
"max": 1,
"minted": 1
},
"image": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"back_image": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"video": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"back_video": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"schema_id": {
"id": "",
"name": "",
"description": ""
},
"is_ipfs": true
}
]
Responses
Body
Examples
{
"id": "",
"name": "",
"description": "",
"is_transferable": true,
"is_burnable": "",
"supply": {
"max": 1,
"minted": 1
},
"image": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"back_image": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"video": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"back_video": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"schema_id": {
"id": "",
"name": "",
"description": ""
},
"is_ipfs": true
}
Responses
Body
Examples
[
{
"id": "",
"schema_attribute": {
"id": "",
"attribute_name": "",
"lexicon": "",
"attribute_type": "",
"priority": ""
},
"default_value": ""
}
]
Request body
Examples
[
{
"id": "",
"schema_attributes": {
"id": ""
},
"default_value": ""
}
]
Responses
Body
Examples
[
{
"id": "",
"schema_attribute": {
"id": "",
"attribute_name": "",
"lexicon": "",
"attribute_type": "",
"priority": ""
},
"default_value": ""
}
]
Request body
i
Examples
{
"name": "",
"description": "",
"is_transferable": true,
"is_burnable": true,
"supply": {
"issued": 1,
"max": 1
},
"schema": {
"id": ""
},
"is_ipfs": true,
"image": {
"id": ""
},
"video": {
"id": ""
},
"back_image": {
"id": ""
},
"back_video": {
"id": ""
}
}
Responses
Body
Examples
{
"id": "",
"name": "",
"description": "",
"is_transferable": true,
"is_burnable": "",
"supply": {
"max": 1,
"minted": 1
},
"image": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"back_image": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"video": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"back_video": {
"id": "string",
"type": "LOGO",
"width": 1,
"height": 1,
"format": "string",
"url": "string",
"thumbnailUrl": "string",
"publicId": "string",
"media": [
{
"width": 1,
"height": 1,
"url": "string"
}
]
},
"schema_id": {
"id": "",
"name": "",
"description": ""
},
"is_ipfs": true
}
Responses
Body
Examples
[
{
"id": "",
"name": "",
"description": "",
"attributes": [
{
"id": "",
"attribute_name": "",
"attribute_type": "",
"lexicon": ""
}
]
}
]
Responses
Request body
Responses
Responses
Body
Examples
[
{
"id": "",
"attribute_name": "",
"attribute_type": "",
"lexicon": ""
}
]
Request body
Examples
[
{
"id": "",
"attribute_name": "",
"lexicon": "",
"attribute_type": "",
"priority": ""
}
]
Responses
Body
Examples
[
{
"id": "",
"attribute_name": "",
"attribute_type": "",
"lexicon": ""
}
]
Request body
Examples
{
"id": "",
"name": "",
"description": ""
}
Responses
{
"event": {
"created_on": 1696869855,
"id": "86a9159f-b409-4c07-a8b2-769d3d603d73",
"type": "TRANSACTION_CREATED"
},
"transaction": {
"id": "guid",
"tx_id": "TX-TEST-102",
"transaction_date": 1696865602,
"reference": "Brazil 1 Ton",
"base_currency": {
"amount": 25,
"currency": "USD"
},
"source_currency": {
"amount": null,
"currency": null
},
"conversion_rate": null,
"wallet": {
"id": "26a14220-a38e-4db9-87f1-d4df7266846f",
"alias": "Jim.C***h-290",
"wallet_address": "8acf5844cd31cb6a6c3def1586722e52"
},
"contact": {
"id": "c3d796b4-89ee-45ae-b7da-08e60beb3c6d",
"name": "Jim Crush",
"email": "andy+jim@meta-carbon.com",
"phone": "+447566224885",
"contact_type": null
},
"co2_kg_units": 1000,
"project": {
"id": "6015cbe1-4ed8-11ed-aec0-42010a9a0004",
"name": "Brazilian Rosewood",
"external_reference": [
{
"id": "633c9b5e-0ed2-11ee-9b0a-42010a9a0007",
"integration": {
"name": "Woo Commerce ( SFT AUTO )",
"id": "a64685fe-5883-44ee-89f2-b1345f7c6b17"
},
"external_reference": "100000000001652"
}
]
},
"campaign": {
"name": "SFT - WooCommerce",
"id": "770b4142-ce5e-443f-b3ed-01d2605fef85"
}
},
"[...]": ""
}
Number of fractional transactions
Responses
Body
Examples
[
{
"id": "",
"name": "",
"description": "",
"rank": {
"min": "",
"max": ""
},
"colour_code": "",
"template": {
"id": "",
"name": ""
},
"priority": 1
}
]
Responses
Body
Examples
{
"id": "",
"name": "",
"description": "",
"rank": {
"min": "",
"max": ""
},
"colour_code": "",
"template": {
"id": "",
"name": ""
},
"priority": 1
}
Request body
Responses
Body
Examples
{
"id": "",
"name": "",
"description": "",
"rank": {
"min": "",
"max": ""
},
"colour_code": "",
"template": {
"id": "",
"name": ""
},
"priority": 1
}
{id}
/projects{id}
/projectsPath variables
Responses
Body
number of retirements related to campaign_id
Total amount retired for the campaign
Total can be more than the retired amount meaning another retirement is required use sum from wallet transaction per project
GET /campaigns/{id}/projects HTTP/1.1
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": "c84929ca-0c1a-4445-b738-ca932ed1b293",
"project": {
"id": "6015b18f-4ed8-11ed-aec0-42010a9a0004",
"name": "Southern Cardamom",
"description": "\"Rangers from this project confiscate more than 1,500 chainsaws a year. That's around 5 a day and each one can clear cut up to one hectare every day!",
"image": {
"id": "3617f2c9-9b5f-4661-b23e-d3c8247cd5ad",
"type": "PHOTO",
"width": 3992,
"height": 2992,
"format": "jpg",
"url": "https://res.cloudinary.com/vizulink-tech-lmimited/image/upload/v1/crm/c74cd62c-4b99-4291-b083-d0ad7aa69c7d/mnk48n6y1nk1ojwv3rey.jpg",
"thumbnail_url": "https://res.cloudinary.com/vizulink-tech-lmimited/image/upload/t_media_lib_thumb/v1/crm/c74cd62c-4b99-4291-b083-d0ad7aa69c7d/mnk48n6y1nk1ojwv3rey.jpg",
"public_id": "crm/c74cd62c-4b99-4291-b083-d0ad7aa69c7d/mnk48n6y1nk1ojwv3rey",
"technology": "CLOUDINARY",
"media": [
{
"id": "323ed829-6239-43ce-994b-0a5a908d1d6b",
"width": 50,
"height": 37,
"url": "https://res.cloudinary.com/vizulink-tech-lmimited/image/upload/c_scale,f_auto,q_auto,w_50/v1/crm/c74cd62c-4b99-4291-b083-d0ad7aa69c7d/mnk48n6y1nk1ojwv3rey.jpg",
"technology": "CLOUDINARY",
"public_id": "crm/c74cd62c-4b99-4291-b083-d0ad7aa69c7d/mnk48n6y1nk1ojwv3rey"
}
],
"created_on": 1664382552000,
"media_external_id": "2c7cbfa5-7861-4347-8a4c-8e06fd3f0e8d",
"media_group_external_id": "2c7cbfa5-7861-4347-8a4c-8e06fd3f0e8d",
"resource_type": "image"
},
"location": {
"region": null,
"country": "Cambodia",
"continent": "Asia",
"location": null,
"boundary": null,
"iso_3166_1": "KH",
"iso_3166_2": "KHM"
}
},
"template": {
"id": "426b4259-b6eb-4e03-ad67-51c3319c90e1",
"name": "Mountain Gorilla - Platinum",
"description": "Platinum Level Gorilla",
"image": {
"id": null,
"type": "PHOTO",
"width": null,
"height": null,
"format": "IPFS",
"url": "https://ipfs.io/ipfs/QmetYcq9xVwopTVg62ezgjXphbPZ5W9hnjtdNJL2GQ39Qx",
"thumbnail_url": null,
"public_id": "QmetYcq9xVwopTVg62ezgjXphbPZ5W9hnjtdNJL2GQ39Qx",
"technology": null,
"media": [
{
"id": "QmetYcq9xVwopTVg62ezgjXphbPZ5W9hnjtdNJL2GQ39Qx",
"width": 1,
"height": 1,
"url": "https://ipfs.io/ipfs/QmetYcq9xVwopTVg62ezgjXphbPZ5W9hnjtdNJL2GQ39Qx",
"technology": "IPFS",
"public_id": "QmetYcq9xVwopTVg62ezgjXphbPZ5W9hnjtdNJL2GQ39Qx"
}
],
"created_on": null,
"media_external_id": null,
"media_group_external_id": null,
"resource_type": null
},
"is_transferable": true,
"is_burnable": true,
"issued_supply": null,
"max_supply": 10
},
"carbon": {
"retired_count": 1,
"retired_co2_kilo_amount": 1,
"total_co2_kilo_amount": 1
}
}