Carbon ShredderGet started

Carbon offset API

Price and buy verified carbon offsets over plain HTTP. Two endpoints, JSON in and out, no API key required to get started.

Base URL

https://carbonshredder.com/api/v1

CORS is open, so you can call the quote endpoint directly from a storefront. Create checkouts server-side where you can attribute the order.

POST /quote

Returns the emissions and the price to offset them. Free to call, and it never charges anything.

curl -X POST https://carbonshredder.com/api/v1/quote \
  -H "Content-Type: application/json" \
  -d '{ "kind": "shipping", "freight_mass_kg": 2, "distance_km": 800, "mode": "ground" }'
{
  "amount_kg": 0.42,
  "price_usd_cents": 131,
  "currency": "usd"
}

Supported kind values

kindparameters
massamount_kg
shippingfreight_mass_kg, distance_km, mode (ground|air)
flightdistance_km
cardistance_km, vehicle_type
traindistance_km
officesquare_footage

POST /checkout

Creates a hosted checkout for the offset and returns its URL. Send your customer there, or open it yourself if you're absorbing the cost. Accepts the same parameters as /quote, plus an optional partner label we store on the order so we can attribute it to you.

curl -X POST https://carbonshredder.com/api/v1/checkout \
  -H "Content-Type: application/json" \
  -d '{ "kind": "mass", "amount_kg": 120, "partner": "acme-store" }'
{
  "url": "https://checkout.stripe.com/c/pay/cs_live_...",
  "amount_kg": 120,
  "price_usd_cents": 331,
  "currency": "usd"
}

Once payment completes we buy and retire exactly that mass of verified credits, and a certificate is produced for the order.

Errors

Errors return a non-2xx status and a JSON body of the form { "error": "..." }. A 400 means the parameters were invalid; a 503 means the pricing service is temporarily unavailable and the request is safe to retry.

Limits & production use

The public endpoints are intended for evaluation and low-volume use, and may be rate limited. For production traffic — plus branded return URLs, volume pricing and a proper API key — get in touch and we'll set up a registered integration.

Building a store? See carbon-neutral checkout for the non-technical overview.

Need a hand integrating?

We'll help you wire it up — usually an afternoon of work.

Contact us