Carbonmark Developers
  • CARBONMARK API
    • Introduction to Carbonmark API
    • Versioning & Release Process
      • v15
      • v16
    • Quickstart
    • Explore Carbon Projects
      • Find carbon projects by country
      • Find carbon projects by vintage
      • Find carbon projects by methodology category
      • Find carbon projects by project name or description
    • Explore Index Products
      • Find index products
    • Retire Carbon
      • Postman Quickstart Guide
    • API Checkout Service (beta)
    • API Reference
  • Transfer Credits
    • Transfer Credits to/from Carbonmark
      • ICR: Import Credits to Carbonmark
      • ICR: Export Credits to ICR
      • Puro Bridge Integration Guide
  • Carbonmark Direct
    • Direct Credit Issuance
  • Resources
    • Contact us
    • Book a demo
    • Terms of Use
    • Privacy Policy
Powered by GitBook
On this page
  • Retire Carbon via Postman
  • 1. Get authenticated
  • 2. Import Carbonmark REST API into Postman
  • 3. Configure your API request
  • 4. Create an Order
  • 5. Confirm your order is complete and view your retirement receipt
  • Want to learn more?
  1. CARBONMARK API
  2. Retire Carbon

Postman Quickstart Guide

Learn how to use Postman to retire carbon via REST API

PreviousRetire CarbonNextAPI Checkout Service (beta)

Last updated 6 months ago

The Retirement API is currently in beta. These endpoints and parameters are in active development and are likely to change.

Carbonmark's Retirement API offers developers a path to initiate carbon retirements via a REST endpoint. is a software tool that helps developers design, build, test and manage APIs. Follow the guide below to get started retiring carbon using Postman:

In this guide, you will learn to:

  • Get access to the Carbonmark developer dashboard and get your API Key

  • Import Carbonmark REST API into Postman

  • Create an order

  • Confirm the status of your order and carbon credit retirement

What is the difference between retiring carbon from a seller listing and retiring carbon from a pool?

Listings can be from an individual or organization seller (i.e. Seller Listing) or from a Carbon Pool. A project may therefore have multiple listings at different price points.

Seller listing prices are controlled by the seller. Carbon Pool pricing is dynamic and can incur slippage.

Retire Carbon via Postman

1. Get authenticated

The API Key is sensitive and can be used to create costly retirements on your behalf. Be careful not to expose the API Key or commit it to your repository.

2. Import Carbonmark REST API into Postman

Depending on whether you select to inherit authorization in your import settings, you may need to set your API key in the request authorization tab and not the collection authorization tab.

3. Configure your API request

Select the newly imported Carbonmark REST API collection. Open the Authorization tab and under Type select Bearer Token from the dropdown menu. Paste your Carbonmark API Key into the Token field. Don't forget to save by clicking the save button.

Navigate to Submit a retirement order in the orders folder. Open the Body tab and configure your retirement order with your desired variables.

4. Create an Order

Send your request by clicking the send button.

You should receive a response containing your order details including order id and status of your order which will allow you to confirm your order has been SUBMITTED and will be completed shortly.

The actual retirement transaction will be initiated instantly by our system, and broadcast to a blockchain network so the underlying credit is permanently retired and taken out of circulation.

It typically takes between 0.5 and 3 seconds for the retirement to be complete — this includes Order creation, transaction broadcast and confirmation on the blockchain, and final retirement certificate generation.

5. Confirm your order is complete and view your retirement receipt

To verify your order has been completed, navigate to get Order details in the orders/{id} folder. Under the params tab, enter the id value of your order.

Send your request by clicking the send button.

You should receive a response indicating the current status of your order. Once your order status is COMPLETED, your order is complete and the carbon credit has been retired.

View retirement receipt

When the transaction is finalized and our system has marked the order status as “complete”, the provided URL should take you to the shareable retirement receipt.

carbonmark.com/retirements/{beneficiaryAddress}/{number}

The order will appear in your developer dashboard as well.

The cost of the order will be added to your monthly invoice.

Want to learn more?

One of our solution specialists would be happy to answer any questions you have.

Either, or sign into the .

Open Postman and click the Import button. Paste this link to import Carbonmark API: Select Postman Collection and click Import. You may want to review your import settings. We recommend using 'Example' as the Parameter generation.

If you've imported the collection correctly, it should be pre-configured with an example; you can see other examples of order to retire from seller listings or carbon pools in our .

You can follow the polygonscan_url or view_retirement_url URLs in the response for further confirmation that your retirement order transaction is complete. Alternatively, you can navigate back to and see the entry and the order status.

For example:

Postman
Request access to the developer dashboard to generate your API Key before proceeding.
download Postman
Postman web application
https://api.carbonmark.com/openapi.json
reference docs
Carbonmark Developer Dashboard
https://www.carbonmark.com/retirements/0xab5b7b5849784279280188b556af3c179f31dc5b/33
Book an API demo
Contact us