---
title: "Calculate checkout rates"
method: POST
path: "/v1/checkout_rates/{config_id}/quotes"
tags: ["checkout_rates"]
---

# Calculate checkout rates

`POST /v1/checkout_rates/{config_id}/quotes`

Calculate the shipping rates a buyer should see at checkout for the given destination and cart, using the delivery options defined on the configuration. The response contains one rate per delivery option that produced a price, and each rate carries its own `quote_id` that can be retrieved later with [Get a checkout rate quote](#operation/get_checkout_rates_quote).

## Request body

- CalculateCheckoutRatesRequestBody — The destination and cart contents to calculate checkout rates for.
  - `ship_to` CheckoutRatesShipTo, required — The destination address to calculate rates for.
    - `address_type` string — The kind of address, when known (for example, `residential` or `commercial`).
    - `address_line1` string — The first line of the street address.
    - `address_line2` string — The second line of the street address, when applicable.
    - `city_locality` string — The city or locality.
    - `state_province` string — The state or province.
    - `postal_code` string — The postal code.
    - `country_code` string — The ISO 3166-1 alpha-2 country code.
  - `items` CheckoutRatesItem[], required — The items in the cart.
    - `name` string — The name of the item.
    - `quantity` integer — The number of units of the item in the cart.
    - `sku` string — The stock keeping unit (SKU) of the item.
    - `price` number — The unit price of the item.
    - `weight` Weight — The weight of a package
      - `value` number, required — The weight, in the specified unit
      - `unit` 'pound' | 'ounce' | 'gram' | 'kilogram', required — The possible weight unit values
    - `dimensions` Dimensions — The dimensions of a package
      - `unit` 'inch' | 'centimeter', required — The dimension units that are supported by ShipEngine.
      - `length` number, required — The length of the package, in the specified unit
      - `width` number, required — The width of the package, in the specified unit
      - `height` number, required — The height of the package, in the specified unit
  - `currency` string — The currency to return rates in.

## Response `200`

The calculated rates for the cart.

- CalculateCheckoutRatesResponseBody — The rates calculated for a cart. Each rate carries its own `quote_id`.
  - `config_id` string — The configuration the rates were calculated against.
  - `rates` CheckoutRatesRateOption[] — The rates to display at checkout, one entry per delivery option that produced a rate. Each entry has its own `quote_id`.
    - `quote_id` string — The unique identifier of this rate's quote. Use it to retrieve the quote later with [Get a checkout rate quote](#operation/get_checkout_rates_quote).
    - `option_id` integer — The identifier of the delivery option this rate was produced for.
    - `option_name` string — The display name of the delivery option.
    - `type` 'live_rate' | 'flat_rate' | 'free' | 'local_delivery' — The delivery option type this rate corresponds to (for example, `live_rate` or `free`).
    - `carrier_id` string, nullable — The carrier this rate is for. `null` for options without a carrier (for example, `free`).
    - `service_code` string, nullable — The carrier service this rate is for. `null` for options without a carrier service.
    - `final_amount` number — The price shown to the buyer after fees or fallbacks are applied.
    - `currency` string — The currency of `final_amount`.
    - `estimated_delivery_days` integer, nullable — The estimated number of days in transit, when available.
    - `estimated_delivery_date` string, date-time, nullable — The estimated delivery date, when available.
  - `created_at` string, date-time — When the quote was calculated.

## Other responses

- `400` — The request contained errors.
- `404` — The specified resource does not exist.
- `500` — An error occurred on ShipEngine's side. > This error will automatically be reported to our engineers.

---

[API](https://skmtc.net/shipstation/apis/shipengine-api.md) · [All operations](https://skmtc.net/shipstation/apis/shipengine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipstation/shipengine-api/revisions/8d8a7cf79204/schema)