POST /v1/climate/orders

Creates a Climate order object for a given Climate product. The order will be processed immediately after creation and payment will be deducted your Stripe balance.

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/x-www-form-urlencoded"

Request body fields

Name Type Required Description
metric_tons String No

Requested number of tons for the order. Either this or amount must be specified.

amount Integer No

Requested amount of carbon removal units. Either this or metric_tons must be specified.

expand[] Array No

Specifies which fields in the response should be expanded.

metadata Object No

Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.

product String Yes

Unique identifier of the Climate product.

beneficiary Object No

Publicly sharable reference for the end beneficiary of carbon removal. Assumed to be the Stripe account if not set.

beneficiary.public_name String Yes
currency String No

Request currency for the order as a three-letter ISO currency code, in lowercase. Must be a supported settlement currency for your account. If omitted, the account's default currency will be used.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.