---
title: "Refresh order quotes"
method: POST
path: "/v1/order/refresh_quotes"
tags: ["Order"]
---

# Refresh order quotes

`POST /v1/order/refresh_quotes`

## Request

- Base URL: `https://api.sandbox.usenash.com`
- URL: `https://api.sandbox.usenash.com/v1/order/refresh_quotes`
- Auth: none declared

Request fresh price quotes from delivery providers for an existing order. Replaces any existing quotes with updated pricing from available providers.

## Request body

- RefreshOrderQuotesInput: Input for refreshing quotes for an order.
  - `orderId` string, nullable: The id of the order to refresh quotes for
  - `externalOrderId` string, nullable: The external id of the order to refresh quotes for

## Response `200`

OK

- RefreshOrderQuotesOutputExample
  - `quotes` QuoteSerializer[], required: The quotes of the order
    - `id` string, required: Quote ID
    - `type` string, nullable: Quote type
    - `providerId` string, required: Provider ID
    - `providerName` string, required: Provider name
    - `providerLogo` string, nullable: Provider logo
    - `providerIsInternal` boolean, nullable: Is the provider internal
    - `createdTime` string, required: Created time
    - `expireTime` string, nullable: Expire time
    - `priceCents` integer, required: Price in cents
    - `taxAmountCents` integer, nullable: Tax amount in cents
    - `tollFeeCents` integer, nullable: Toll fee in cents
    - `nashFeeCents` integer, nullable: Nash fee in cents
    - `insuranceFeeCents` integer, nullable: Insurance fee in cents
    - `currency` string, nullable: Currency
    - `pickupWindow` string, nullable: Pickup window
    - `dropoffEta` string, nullable: Dropoff ETA
    - `tags` string[], nullable: Tags
    - `costSplitCustomerCents` integer, nullable: Cost split customer in cents
    - `costSplitBusinessCents` integer, nullable: Cost split business in cents
    - `totalPriceBreakdown` object, nullable: Total price breakdown
    - `totalPriceCents` integer, nullable: Total price in cents
    - `rank` integer, nullable: Quote rank for preferred provider ordering
    - `price` number, nullable: Price
    - `isSuccessful` boolean, nullable: Is successful
    - `errorMessage` string, nullable: Error message
    - `errorCode` string, nullable: Machine-readable quote failure code
    - `errorDetails` object, nullable: Structured quote failure details

## Other responses

- `422`: Unprocessable Content

---

[API](https://skmtc.dev/nash/apis/nash-api.md) - [All operations](https://skmtc.dev/nash/apis/nash-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nash/apis/nash-api/revisions/e3713837c5c9?raw)
