Retrieve an order

Retrieves the details of a Climate order object with the given ID.

Parameters

orderstringRequired
Unique identifier of the order.

Returns

Returns a Climate order object if a valid identifier was provided. Throws an error otherwise.

GET /v1/climate/orders/:id

Server-side language

curl https://api.stripe.com/v1/climate/orders/climorder_1aTnU0B63jkB3XAQKUbA5yyl \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:"

Response

{
  "id": "climorder_1aTnU0B63jkB3XAQKUbA5yyl",
  "object": "climate.order",
  "amount_fees": 17,
  "amount_subtotal": 550,
  "amount_total": 567,
  "beneficiary": {
    "public_name": "{{YOUR_BUSINESS_NAME}}"
  },
  "canceled_at": null,
  "cancellation_reason": null,
  "certificate": null,
  "confirmed_at": 1881439205,
  "created": 1881439205,
  "currency": "usd",
  "delayed_at": null,
  "delivered_at": null,
  "delivery_details": [],
  "expected_delivery_year": 2027,
  "livemode": false,
  "metadata": {},
  "metric_tons": "0.01",
  "product": "climsku_frontier_offtake_portfolio_2027",
  "product_substituted_at": null,
  "status": "confirmed"
}

List orders

Lists all Climate order objects. The orders are returned sorted by creation date, with the most recently created orders appearing first.

Parameters

No parameters.

More parameters

ending_beforestring

limitinteger

starting_afterstring

Returns

A dictionary with a data property that contains an array of up to limit orders, starting after order starting_after. Each entry in the array is a separate order object. If no more orders are available, the resulting array is empty.

GET /v1/climate/orders

Server-side language

curl -G https://api.stripe.com/v1/climate/orders \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -d limit=3

Response

{
  "object": "list",
  "url": "/v1/climate/orders",
  "has_more": false,
  "data": [
    {
      "id": "climorder_1aTnU0B63jkB3XAQKUbA5yyl",
      "object": "climate.order",
      "amount_fees": 17,
      "amount_subtotal": 550,
      "amount_total": 567,
      "beneficiary": {
        "public_name": "{{YOUR_BUSINESS_NAME}}"
      },
      "canceled_at": null,
      "cancellation_reason": null,
      "certificate": null,
      "confirmed_at": 1881439205,
      "created": 1881439205,
      "currency": "usd",
      "delayed_at": null,
      "delivered_at": null,
      "delivery_details": [],
      "expected_delivery_year": 2027,
      "livemode": false,
      "metadata": {},
      "metric_tons": "0.01",
      "product": "climsku_frontier_offtake_portfolio_2027",
      "product_substituted_at": null,
      "status": "confirmed"
    }
  ]
}

Cancel an order

Cancels a Climate order. You can cancel an order within 24 hours of creation. Stripe refunds the reservation amount_subtotal, but not the amount_fees for user-triggered cancellations. Frontier might cancel reservations if suppliers fail to deliver. If Frontier cancels the reservation, Stripe provides 90 days advance notice and refunds the amount_total.

Parameters

orderstringRequired
Unique identifier of the order.

Returns

The canceled Climate order object.

POST /v1/climate/orders/:id/cancel

Server-side language

curl -X POST https://api.stripe.com/v1/climate/orders/climorder_1aTnU0B63jkB3XAQKUbA5yyl/cancel \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:"

Response

{
  "id": "climorder_1aTnU0B63jkB3XAQKUbA5yyl",
  "object": "climate.order",
  "amount_fees": 17,
  "amount_subtotal": 550,
  "amount_total": 567,
  "beneficiary": {
    "public_name": "{{YOUR_BUSINESS_NAME}}"
  },
  "canceled_at": 1881439208,
  "cancellation_reason": "requested",
  "certificate": null,
  "confirmed_at": 1881439205,
  "created": 1881439205,
  "currency": "usd",
  "delayed_at": null,
  "delivered_at": null,
  "delivery_details": [],
  "expected_delivery_year": 2027,
  "livemode": false,
  "metadata": {},
  "metric_tons": "0.01",
  "product": "climsku_frontier_offtake_portfolio_2027",
  "product_substituted_at": null,
  "status": "canceled"
}