Stripe: Climate schemas
7 Stripe schemas with complete fields and constraints.
← Climate operations · All schemas
Cancel an order — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Orders represent your intent to purchase a particular Climate product. When you create an order, the payment is deducted from your merchant balance. |
amount_fees | JSON | Required within parent | |
amount_fees (anyOf 1) | integer | Alternative | Total amount of [Frontier](https://frontierclimate.com/)'s service fees in the currency's smallest unit. |
amount_fees (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
amount_subtotal | JSON | Required within parent | |
amount_subtotal (anyOf 1) | integer | Alternative | Total amount of the carbon removal in the currency's smallest unit. |
amount_subtotal (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
amount_total | JSON | Required within parent | |
amount_total (anyOf 1) | integer | Alternative | Total amount of the order including fees in the currency's smallest unit. |
amount_total (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
beneficiary | Model | Optional | Expand Cancel an order — response body — beneficiary |
canceled_at | JSON | Optional | |
canceled_at (anyOf 1) | JSON | Alternative | |
canceled_at (anyOf 1) (anyOf 1) | integer | Alternative | Time at which the order was canceled. Measured in seconds since the Unix epoch. Format: unix-time |
canceled_at (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
canceled_at (anyOf 2) | null | Alternative | |
cancellation_reason | JSON | Optional | |
cancellation_reason (anyOf 1) | string | Alternative | Reason for the cancellation of this order. Known values: expired, product_unavailable, requested |
cancellation_reason (anyOf 2) | null | Alternative | |
certificate | JSON | Optional | |
certificate (anyOf 1) | string | Alternative | For delivered orders, a URL to a delivery certificate for the order. Maximum length: 5000 |
certificate (anyOf 2) | null | Alternative | |
confirmed_at | JSON | Optional | |
confirmed_at (anyOf 1) | JSON | Alternative | |
confirmed_at (anyOf 1) (anyOf 1) | integer | Alternative | Time at which the order was confirmed. Measured in seconds since the Unix epoch. Format: unix-time |
confirmed_at (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
confirmed_at (anyOf 2) | null | Alternative | |
created | JSON | Required within parent | |
created (anyOf 1) | integer | Alternative | Time at which the object was created. Measured in seconds since the Unix epoch. Format: unix-time |
created (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
currency | string | Required within parent | Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase, representing the currency for this order. Maximum length: 5000 |
delayed_at | JSON | Optional | |
delayed_at (anyOf 1) | JSON | Alternative | |
delayed_at (anyOf 1) (anyOf 1) | integer | Alternative | Time at which the order's expected_delivery_year was delayed. Measured in seconds since the Unix epoch. Format: unix-time |
delayed_at (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
delayed_at (anyOf 2) | null | Alternative | |
delivered_at | JSON | Optional | |
delivered_at (anyOf 1) | JSON | Alternative | |
delivered_at (anyOf 1) (anyOf 1) | integer | Alternative | Time at which the order was delivered. Measured in seconds since the Unix epoch. Format: unix-time |
delivered_at (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
delivered_at (anyOf 2) | null | Alternative | |
delivery_details | array | Required within parent | Details about the delivery of carbon removal for this order. |
delivery_details[] | Model | Each item | Expand Cancel an order — response body — delivery details item |
expected_delivery_year | JSON | Required within parent | |
expected_delivery_year (anyOf 1) | integer | Alternative | The year this order is expected to be delivered. If the year is in the past, the order is a spot purchase and will be delivered within 30 days of purchase. |
expected_delivery_year (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
id | string | Required within parent | Unique identifier for the object. Maximum length: 5000 |
livemode | boolean | Required within parent | Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. |
metadata | object | Required within parent | Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Additional keys: see wildcard field |
metadata.* | string | Additional keys | Maximum length: 500 |
metric_tons | string | Required within parent | Quantity of carbon removal that is included in this order. Format: decimal |
object | string | Required within parent | String representing the object's type. Objects of the same type share the same value. Known values: climate.order |
product | JSON | Required within parent | Unique ID for the Climate `Product` this order is purchasing. |
product (anyOf 1) | string | Alternative | Maximum length: 5000 |
product (anyOf 2) | Model | Alternative | Expand Retrieve a product — climate get Climate Products Product — response body |
product_substituted_at | JSON | Optional | |
product_substituted_at (anyOf 1) | JSON | Alternative | |
product_substituted_at (anyOf 1) (anyOf 1) | integer | Alternative | Time at which the order's product was substituted for a different product. Measured in seconds since the Unix epoch. Format: unix-time |
product_substituted_at (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
product_substituted_at (anyOf 2) | null | Alternative | |
status | string | Required within parent | The current status of this order. Known values: awaiting_funds, canceled, confirmed, delivered, open |
Referenced models: Retrieve a product — climate get Climate Products Product — response body, Cancel an order — response body — beneficiary, Cancel an order — response body — delivery details item
Cancel an order — response body — beneficiary
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
public_name | string | Required within parent | Publicly displayable name for the end beneficiary of carbon removal. Maximum length: 5000 |
Cancel an order — response body — delivery details item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | The delivery of a specified quantity of carbon for an order. |
delivered_at | JSON | Required within parent | |
delivered_at (anyOf 1) | integer | Alternative | Time at which the delivery occurred. Measured in seconds since the Unix epoch. Format: unix-time |
delivered_at (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
location | JSON | Optional | |
location (anyOf 1) | JSON | Alternative | Specific location of this delivery. |
location (anyOf 1) (anyOf 1) | Model | Alternative | Expand Retrieve a supplier — response body — locations item |
location (anyOf 2) | null | Alternative | |
metric_tons | string | Required within parent | Quantity of carbon removal supplied by this delivery. Maximum length: 5000 |
registry_url | JSON | Optional | |
registry_url (anyOf 1) | string | Alternative | Once retired, a URL to the registry entry for the tons from this delivery. Maximum length: 5000 |
registry_url (anyOf 2) | null | Alternative | |
supplier | Model | Required within parent | Expand Retrieve a supplier — response body |
Referenced models: Retrieve a supplier — response body, Retrieve a supplier — response body — locations item
Retrieve a product — climate get Climate Products Product — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | A Climate product represents a type of carbon removal unit available for reservation. You can retrieve it to see the current price and availability. |
created | JSON | Required within parent | |
created (anyOf 1) | integer | Alternative | Time at which the object was created. Measured in seconds since the Unix epoch. Format: unix-time |
created (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
current_prices_per_metric_ton | object | Required within parent | Current prices for a metric ton of carbon removal in a currency's smallest unit. Additional keys: see wildcard field |
current_prices_per_metric_ton.* | Model | Additional keys | Expand Retrieve a product — climate get Climate Products Product — response body — current prices per metric ton value |
delivery_year | JSON | Optional | |
delivery_year (anyOf 1) | JSON | Alternative | |
delivery_year (anyOf 1) (anyOf 1) | integer | Alternative | The year in which the carbon removal is expected to be delivered. If the year is in the past, this represents spot inventory with guaranteed delivery. |
delivery_year (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
delivery_year (anyOf 2) | null | Alternative | |
id | string | Required within parent | Unique identifier for the object. For convenience, Climate product IDs are human-readable strings that start with `climsku_`. See [carbon removal inventory](https://stripe.com/docs/climate/orders/carbon-removal-inventory) for a list of available carbon removal products. Maximum length: 5000 |
livemode | boolean | Required within parent | Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. |
metric_tons_available | string | Required within parent | The quantity of metric tons available for reservation. Format: decimal |
name | string | Required within parent | The Climate product's name. Maximum length: 5000 |
object | string | Required within parent | String representing the object's type. Objects of the same type share the same value. Known values: climate.product |
suppliers | array | Required within parent | The carbon removal suppliers that fulfill orders for this Climate product. |
suppliers[] | Model | Each item | Expand Retrieve a supplier — response body |
Referenced models: Retrieve a supplier — response body, Retrieve a product — climate get Climate Products Product — response body — current prices per metric ton value
Retrieve a product — climate get Climate Products Product — response body — current prices per metric ton value
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
amount_fees | JSON | Required within parent | |
amount_fees (anyOf 1) | integer | Alternative | Fees for one metric ton of carbon removal in the currency's smallest unit. |
amount_fees (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
amount_subtotal | JSON | Required within parent | |
amount_subtotal (anyOf 1) | integer | Alternative | Subtotal for one metric ton of carbon removal (excluding fees) in the currency's smallest unit. |
amount_subtotal (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
amount_total | JSON | Required within parent | |
amount_total (anyOf 1) | integer | Alternative | Total for one metric ton of carbon removal (including fees) in the currency's smallest unit. |
amount_total (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
Retrieve a supplier — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | A supplier of carbon removal. |
id | string | Required within parent | Unique identifier for the object. Maximum length: 5000 |
info_url | string | Required within parent | Link to a webpage to learn more about the supplier. Maximum length: 5000 |
livemode | boolean | Required within parent | Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. |
locations | array | Required within parent | The locations in which this supplier operates. |
locations[] | Model | Each item | Expand Retrieve a supplier — response body — locations item |
name | string | Required within parent | Name of this carbon removal supplier. Maximum length: 5000 |
object | string | Required within parent | String representing the object’s type. Objects of the same type share the same value. Known values: climate.supplier |
removal_pathway | string | Required within parent | The scientific pathway used for carbon removal. Known values: biomass_carbon_removal_and_storage, direct_air_capture, enhanced_weathering, marine_carbon_removal |
Referenced models: Retrieve a supplier — response body — locations item
Retrieve a supplier — response body — locations item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
city | JSON | Optional | |
city (anyOf 1) | string | Alternative | The city where the supplier is located. Maximum length: 5000 |
city (anyOf 2) | null | Alternative | |
country | string | Required within parent | Two-letter ISO code representing the country where the supplier is located. Maximum length: 5000 |
latitude | JSON | Optional | |
latitude (anyOf 1) | JSON | Alternative | |
latitude (anyOf 1) (anyOf 1) | number | Alternative | The geographic latitude where the supplier is located. |
latitude (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
latitude (anyOf 2) | null | Alternative | |
longitude | JSON | Optional | |
longitude (anyOf 1) | JSON | Alternative | |
longitude (anyOf 1) (anyOf 1) | number | Alternative | The geographic longitude where the supplier is located. |
longitude (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
longitude (anyOf 2) | null | Alternative | |
region | JSON | Optional | |
region (anyOf 1) | string | Alternative | The state/county/province/region where the supplier is located. Maximum length: 5000 |
region (anyOf 2) | null | Alternative |