Properties
| Name | Type | Description |
|---|---|---|
| value | string | Maximum price of CO2 offsets to purchase (in the account's currency). `value` must not be lower than the currency's minimum unit. |
| idempotency_key | string | Account-unique identifier provided by the client. `idempotency_key` has two purposes: 1. Clients can use `idempotency_key` to prevent duplicate orders. 2. Clients can use `idempotency_key` to reconcil |
| bundle_selection | object | Bundle selection to be used for the order. For the order, this property overrides the account's bundle selection. |
| metadata | object | |
| quantity_trunc | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/lune/json-schema/lune-create-order-by-value-request-schema.json",
"title": "CreateOrderByValueRequest",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/lune-orders-api-openapi.yml#/components/schemas/CreateOrderByValueRequest",
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"type": "string",
"pattern": "^[0-9]+(\\.[0-9]+)?$",
"description": "Maximum price of CO2 offsets to purchase (in the account's currency).\n\n`value` must not be lower than the currency's minimum unit.\n"
},
"idempotency_key": {
"type": "string",
"maxLength": 100,
"description": "Account-unique identifier provided by the client.\n\n`idempotency_key` has two purposes:\n1. Clients can use `idempotency_key` to prevent duplicate orders.\n2. Clients can use `idempotency_key` to reconcile orders with other entities on their system.\n\nIf an order with the same `idempotency_key` already exists, the API returns\nHTTP 409 Conflict with error code `order_idempotency_already_exists`. To\nretrieve the existing order, use the\n`GET /v1/orders/by-idempotency-key/{idempotency_key}` endpoint.\n"
},
"bundle_selection": {
"description": "Bundle selection to be used for the order.\nFor the order, this property overrides the account's bundle selection.\n",
"$ref": "#/$defs/BundleSelectionRequest"
},
"metadata": {
"$ref": "#/$defs/Metadata",
"default": {}
},
"quantity_trunc": {
"$ref": "#/$defs/QuantityTrunc"
}
},
"$defs": {
"BundlePercentageRequest": {
"type": "object",
"description": "Maps a bundle id to an allocation ratio",
"required": [
"bundle_id"
],
"properties": {
"bundle_id": {
"type": "string",
"description": "The bundle's unique identifier"
},
"percentage": {
"oneOf": [
{
"type": "integer",
"x-lune-name": "Selection percentage as integer",
"description": "Selection percentage"
},
{
"type": "string",
"pattern": "^[0-9]+(\\.\\d{1,2})?$",
"x-lune-name": "Selection percentage in decimals",
"description": "Selection percentage in decimals"
}
]
}
}
},
"BundleSelectionRequest": {
"type": "array",
"description": "Bundle selection percentages.\n\nThe sum of all percentages must equal 100.\n\nIf not specified, the preconfigured allocation ratios are going to be used.\n\nIf, for each selection, `percentage` is not provided, the selection is divided equally (best effort) between bundles. `percentage` must be provided for all or none of the bundles.\n",
"items": {
"$ref": "#/$defs/BundlePercentageRequest"
}
},
"MassUnit": {
"x-lune-name": "Mass",
"type": "string",
"description": "Unit, `t` for tonne, `kg` for kilogram, `g` for gram, `lbs` for pound",
"enum": [
"g",
"kg",
"t",
"lbs"
]
},
"Metadata": {
"description": "An arbitrary dictionary (key-value pairs) to store application-specific information.\n\nLune doesn't use this information for order processing. Its purpose is for the API\nclients to be able to attach arbitrary information (to an order for example) and\nthen retrieve it.\n",
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"QuantityTrunc": {
"description": "Selects to which precision to truncate quantities specific to carbon offsetting.",
"allOf": [
{
"$ref": "#/$defs/MassUnit"
}
]
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/lune-create-order-by-value-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.