POST
/
orders
/
{id}
/
cancel

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Subaccount-Id
string

If present, scopes the operation to the subaccount with given id. See Subaccounts for more info.

Idempotency-Key
string

If present, a unique identifier that allows you to retry a request multiple times while only performing the action once. See Idempotency for more info.

Path Parameters

id
string
required

ID of order to cancel

Response

200 - application/json
id
string

Identifier that can be used to retrieve the order details

order_number
string

Hex representation derived from the order id that will be shown on the certificate

created_on
string

Timestamp of when the order was created (in UTC)

metadata
string | null

Optional metadata that was provided with the order

Maximum length: 512
description
string | null

Optional public description for the order that will be shown on the certificate, as provided when order was placed

Maximum length: 512
amount_kg
number

Amount of credits purchased, in kg of CO<sub>2</sub>e

state
enum<string>

The current state of the order.

  • placed - the order has been placed, and is waiting to be matched against available credits in our system.
  • fulfilled - the order has been fulfilled by matching it against available credits in our system, which have been retired.
  • canceled - the order has been canceled
Available options:
placed,
fulfilled,
cancelled
price_usd_cents
number

Amount charged for the credits purchased, in cents (integer)

callback_url
string

Callback URL to invoke when status of the order changes, if specified in the order

certificate_public_url
string | null

URL for the publicly accessible page showing order details and the certificate. This will be null if the order state is cancelled

certificate_download_public_url
string | null

URL for downloading the certificate PDF. This will be null if the order state is cancelled

project_allocations
object[]

For fulfilled orders, a list of the projects that were used to fulfill the order

checkout_session_id
string | null

Id of the checkout session whose completion resulted in the creation of this order. Null if the order did not originate from a checkout session.