Rate-card pricing - Run Delivery

Custom Bike / Bus·Van / Truck rates are set up by RUN admin after agreement with your business. The Business API does not negotiate or edit those rates. Once RUN has enabled your rate cards, your integration:

Reads the options already on your account (GET /business/rate-cards)
Quotes and places with vehicle_type / option_id / weight

Field model

Field	Role
`item_name`	Parcel only (for example “shoes”) — not used for pricing
`vehicle_type`	`bike`, `bus_van`, or `truck`
`weight`	Billable kg; for bike also selects the weight band
`option_id`	From Rate cards; required for bus_van / truck; omit for bike

Do not hardcode prices or option IDs. When RUN updates your card, keep using the catalog + quote endpoints.

Flow

GET /business/rate-cards — cache vehicle_type and options[].id (read-only)
POST /business/order/cost — same vehicle_type, option_id (if needed), weight, addresses
POST /business/order — same pricing fields on each shipment

# 1. List options RUN already configured for you
curl -s "$BASE/business/rate-cards" -H "Authorization: Bearer $RUN_API_KEY"

# 2. Quote (bike — weight picks the band)
curl -s -X POST "$BASE/business/order/cost" \
  -H "Authorization: Bearer $RUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup_address": "15 Bode Thomas Street, Surulere, Lagos",
    "dropoff_address": "24 Allen Avenue, Ikeja, Lagos",
    "weight": 2,
    "vehicle_type": "bike"
  }'

# 3. Quote (bus / van — option required)
curl -s -X POST "$BASE/business/order/cost" \
  -H "Authorization: Bearer $RUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup_address": "15 Bode Thomas Street, Surulere, Lagos",
    "dropoff_address": "Igando Roundabout, Igando, Lagos",
    "weight": 50,
    "vehicle_type": "bus_van",
    "option_id": "open_space_bus"
  }'

When to omit `vehicle_type`

If you omit vehicle_type, Run quotes with distance pricing (km + weight platform rates). Prefer setting vehicle_type when RUN has enabled a rate card for your account.

Next