Retrieve an instant quote

GEThttps://sandbox-api.tryflume.ai/partner/v1/quotes/{quote_uuid}

Returns an instant quote by id, in the same shape as POST /request-instant-quote.

Use it to poll a quote that is still pricing.
Poll every 12 seconds for 2 minutes, then every 30 seconds until 5 minutes, then stop.
No daily limit is used.

curl -X GET "https://sandbox-api.tryflume.ai/partner/v1/quotes/9c1e4b7a-2f3d-4e5b-8a6c-7d8e9f0a1b2c" \
  -H "X-Flume-Partner-Key: $FLUME_PARTNER_KEY" \
  -H "X-Flume-User-Token: $FLUME_USER_TOKEN"

import os

import requests

headers = {
    "X-Flume-Partner-Key": os.environ["FLUME_PARTNER_KEY"],
    "X-Flume-User-Token": os.environ["FLUME_USER_TOKEN"],
}

response = requests.get(
    "https://sandbox-api.tryflume.ai/partner/v1/quotes/9c1e4b7a-2f3d-4e5b-8a6c-7d8e9f0a1b2c",
    headers=headers,
    timeout=30,
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://sandbox-api.tryflume.ai/partner/v1/quotes/9c1e4b7a-2f3d-4e5b-8a6c-7d8e9f0a1b2c", {
  method: "GET",
  headers: {
    "X-Flume-Partner-Key": process.env.FLUME_PARTNER_KEY,
    "X-Flume-User-Token": process.env.FLUME_USER_TOKEN,
  },
});
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
console.log(await response.json());

{
  "status": "READY",
  "failure_reason": null,
  "quote_uuid": "9c1e4b7a-2f3d-4e5b-8a6c-7d8e9f0a1b2c",
  "quote": {
    "quote_uuid": "9c1e4b7a-2f3d-4e5b-8a6c-7d8e9f0a1b2c",
    "quote_number": "Q-7KD2-M4PA",
    "sku_uuid": "7f3c2a91-4b0e-4c8d-9a21-1f6b2d5e7c30",
    "destination_zip": "22102",
    "currency": "USD",
    "created_at": "2026-10-16T09:14:22Z",
    "valid_until": "2026-10-23T09:14:22Z",
    "options": [
      {
        "source": "OVERSEAS_DIRECT",
        "lead_time_min_days": 90,
        "lead_time_max_days": 120,
        "ships_from_country": "ES",
        "quantity_sqft": "6000.00",
        "price_per_sqft": "6.40",
        "subtotal": "38400.00",
        "sales_tax": "3168.00",
        "total": "41568.00"
      },
      {
        "source": "US_WAREHOUSE",
        "lead_time_min_days": 14,
        "lead_time_max_days": 30,
        "ships_from_country": "US",
        "quantity_sqft": "6000.00",
        "price_per_sqft": "8.10",
        "subtotal": "48600.00",
        "sales_tax": "4009.50",
        "total": "52609.50"
      }
    ]
  }
}

Request

Headers

Header	Required	Description
`X-Flume-Partner-Key`	Yes	Your partner key. See Authentication and keys.
`X-Flume-User-Token`	Yes	The access token of the user you call for. See Users and verification.

Path parameters

Parameter	Type	Description
`quote_uuid`	string	The quote's id, from `POST /request-instant-quote`.

This call takes no body.

Returns

200 with these fields. Every field is always present. A field with no value is null.

statusenum
READY or FAILED.
failure_reasonenum or null
With FAILED: why there are no prices. TEMPORARILY_UNAVAILABLE can mean the quote is still pricing.
One of
- NOT_QUOTABLE
- TEMPORARILY_UNAVAILABLE
- REGION_RESTRICTED
- INCORRECT_DESTINATION
quote_uuidstring (UUID) or null
The id to poll with. Send it to GET /quotes/{quote_uuid} while the quote is still pricing. Every response has it.
quoteobject or null
The prices, with READY. Otherwise null.
ShowHide the 8 fields of quote
- quote_uuidstring (UUID)
  The quote's id in the user's Flume account.
- quote_numberstring
  The quote's number, as the user sees it in Flume.
- sku_uuidstring (UUID)
  The product priced.
- destination_zipstring
  The delivery ZIP code.
- currencystring
  Always USD.
  - Default "USD"
- created_atstring
  When the quote was priced, in UTC.
- valid_untilstring
  The prices hold until this time, in UTC.
- optionsarray of objects
  One entry per shipping option, cheapest total first.
  ShowHide the 9 fields of options
  - sourceenum
    How this option ships: US_WAREHOUSE or OVERSEAS_DIRECT.
  - ships_from_countrystring or null
    The 2-letter code of the country the option ships from, or null.
  - lead_time_min_daysinteger
    The shortest delivery time, in days.
  - lead_time_max_daysinteger
    The longest delivery time, in days.
  - quantity_sqftstring
    The quantity priced, in square feet.
  - price_per_sqftstring
    The delivered price per square foot, before tax.
  - subtotalstring
    The delivered price, before tax.
  - sales_taxstring or null
    The sales tax, or null.
  - totalstring
    The delivered price, including sales tax.

Errors

Every error uses one envelope. Branch on error.code.

Status	Code	Meaning
401	`EMBED_TOKEN_INVALID`	You sent an `Authorization` header and no `X-Flume-Partner-Key`. Flume read the call as one from its own iframe.
401	`PARTNER_KEY_INVALID`	The partner key is missing, unknown, revoked, expired, or from the other environment. On live, also a platform Flume has not enabled yet.
401	`USER_TOKEN_INVALID`	The user access token is unknown, revoked, another partner's, or replaced by a later verification. A verification in the iframe replaces it too.
403	`USER_ACCOUNT_CLOSED`	The user's email belongs to a Flume account that Flume has closed.
403	`USER_NOT_CONNECTED`	No `X-Flume-User-Token` header was sent.
404	`NOT_FOUND`	The thing does not exist, or is not this user's. A search id that is not a UUID also returns this code.
422	`VALIDATION_FAILED`	A field is missing, unknown or has an unusable value. `field` names it as a dotted path. Some refusals carry the detail in `details` and leave `field` empty.
500	`INTERNAL`	Something failed on Flume's side.