FleetbaseFleetbase

Delivery Service Quote

Delivery service quotes estimate the fulfillment cost for a storefront cart. Use this endpoint before checkout when an order requires delivery instead of pickup.

The Delivery Service Quote object

A delivery service quote prices delivery for a storefront cart and is used at checkout.
Attributes
idstringoptional

Public identifier of the service quote.

service_ratestringoptional

Service rate the quote was priced with.

service_rate_namestringoptional

Name of the service rate.

service_namestringoptional

Name of the delivery service.

facilitatorstringoptional

Integrated vendor that produced the quote, or null for the store's own rates.

request_idstringoptional

Identifier of the quote request.

amountintegeroptional

Quoted delivery amount in the currency's smallest unit.

currencycurrencyoptional

Quote currency code.

itemsarrayoptional

Line items that make up the quoted amount.

metaobjectoptional

Origin and destination used for the quote. For a multi-store Network cart, origin is an array of place IDs.

The Delivery Service Quote object
{
  "id": "service_quote_4fK2mQ8",
  "service_rate": "service_rate_7Hq2xL9",
  "service_rate_name": "Standard delivery",
  "service_name": "Standard delivery",
  "facilitator": null,
  "request_id": "c2f1a7d4-2b8e-4c51-9d0a-6f3e1b2c4d5e",
  "amount": 950,
  "currency": "USD",
  "items": [
    {
      "amount": 950,
      "currency": "USD",
      "details": "Base fee and distance"
    }
  ],
  "meta": {
    "origin": "place_123",
    "destination": "place_456"
  },
  "created_at": "2026-10-07T13:30:00Z",
  "updated_at": "2026-10-07T13:30:00Z"
}
GET/v1/service-quotes/from-cart

Retrieve a Delivery Service Quote ❗

Returns a delivery service quote for the supplied cart, origin, and destination. Use the quote's id as service_quote at checkout to include delivery pricing. Returns a single quote, or an array with all=1.

For a multi-store Network cart the distance is summed leg by leg: from the farthest store, to the nearest next store, then to the customer.

Errors: 422 with code: "cart_items_unavailable" and items: [{ id, product_id, name }] when a product in the cart was deleted, made unavailable or unpublished, or a line's food truck or store location no longer exists (show it to the customer and send them back to the cart). 400 for a missing origin or destination, no service rates, or an unknown integrated vendor. 422 when a Network store location is not available in the network.

Query parameters
cartstringrequired

Cart public ID or unique identifier. Network cart origins must belong to the corresponding member stores.

destinationstringrequired

Where to deliver: a place ID, store location ID, vehicle ID, food truck ID, or a lat,lng pair.

originstringoptional

Where the delivery starts, in the same formats as destination. Required for a store key (a store location must belong to that store). For a network key it's optional: each cart line's store location is used, and origin (or comma-separated IDs) is only a fallback.

facilitatorstringoptional

Integrated vendor ID or provider to quote with instead of the store's own service rates.

scheduled_attimestampoptional

Requested delivery time, forwarded to integrated vendors.

service_typestringoptional

Service type, forwarded to integrated vendors.

allbooleanoptionalDefault: false

Return every available quote as an array instead of the single best quote.

is_route_optimizedbooleanoptionalDefault: true

Whether the route through several stores is optimized when pricing a multi-store cart.

GET/v1/service-quotes/from-cart
curl https://api.fleetbase.io/v1/service-quotes/from-cart?origin=1.3521%2C103.8198&destination=1.3644%2C103.9915&cart={{cart_id}} \
  -H "Authorization: Bearer flb_live_…"
Delivery Service Quote | Fleetbase