POST
/
v1
/
quotes
/
ground-transport
Get a carbon credit quote for ground transport emissions
curl --request POST \
  --url https://carbon-engine.onrender.com/v1/quotes/ground-transport \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "distance_km": 123,
  "vehicle_type": "<string>",
  "portfolio_id": "<string>"
}'
{
  "amount_kg": 123,
  "price_sar_halalas": 123
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
distance_km
number
required

Distance of ground transportation, in km

​
vehicle_type
string
required

The type of vehicle used. Must be one of passenger_car_van_or_suv, small_bus, school_bus, or coach_bus.

​
portfolio_id
string | null

Optional ID of the portfolio to use for the quote. The quote will be for an order fulfilled from this portfolio. If not specified, the account's default portfolio will be used.

Response

Fetched ground freight quote successfully

​
amount_kg
number

Amount of carbon credits the quote is for, in kilograms

​
price_sar_halalas
number

Price charged for the credits, in halalas (integer)