List Quotes | BigCommerce Developer Center

Retrieves basic information for all sales quotes in your store. Use the parameters to narrow your results, such as filtering by a date range or quotes from a specific Company account.

More detailed information, such as line items and shipping details, can be retrieved with the Get Quote Details endpoint.

Authentication

X-Auth-Tokenstring

Authentication header

Header	Argument	Description
`X-Auth-Token`	`access_token`	For more about API accounts that generate `access_token`s, see our Guide to API Accounts.

### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Auth-Token` | `access_token` | For more about API accounts that generate `access_token`s, see our [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts). | ### Further reading For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-fundamentals/api-accounts#x-auth-token-header-example-requests). For more about BigCommerce OAuth scopes, see our [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts#oauth-scopes). For a list of API status codes, see [API Status Codes](/developer/api-reference/rest/overview#rest-http-status-codes).

X-Store-Hashstring

Authentication header

Header	Argument	Description
`X-Store-Hash`	`store_hash`	The unique store hash associated with a BigCommerce store that has B2B Edition enabled.

### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Store-Hash` | `store_hash` | The unique store hash associated with a BigCommerce store that has B2B Edition enabled. |

Query parameters

offsetintegerOptional

The number of results to skip before returning the first result. If left blank, this defaults to 0.

limitintegerOptional

Determines the number of records to return per page. If left blank, this defaults to 10.

sortByenumOptionalDefaults to updatedAt

Sorts results by Company name (company), quote status (status), sales rep name (salesRep), creation date (createdAt), expiration date (expiredAt), or last updated date (updatedAt). It defaults to the last updated date if no parameter is provided.

orderByenumOptionalDefaults to desc

Establish a descending or ascending order of results. The order defaults to descending if the parameter is not included.

Allowed values:

qstringOptional

Enter quote information to return partial and exact matches. Accepted information fields include quote number, quote title, Company name, assigned sales rep, and Company user first and last name.

quoteNumberstringOptional

Enter a full or partial quote number to retrieve relevant quotes.

companystringOptional

Enter a full or partial Company name to retrieve relevant quotes.

salesRepstringOptional

The name of the sales rep assigned to the quote.

statusenumOptional

The backend status of the sales quote. Note that these are not the same as buyer-facing quote status. See Quote Statuses for more information.

quoteTitlestringOptional

The external title given to the quote.

createdBystringOptional

The name of the sales rep or buyer who created the quote.

maxCreatedintegerOptional

Enter a Unix timestamp to retrieve all quotes created before that time.

Enter a [Unix timestamp](https://www.unixtimestamp.com/) to retrieve all quotes created before that time.

minCreatedintegerOptional

Enter a Unix timestamp to retrieve all quotes created after that time.

Enter a [Unix timestamp](https://www.unixtimestamp.com/) to retrieve all quotes created after that time.

maxModifiedintegerOptional

Enter a Unix timestamp to retrieve all quotes modified before that time.

Enter a [Unix timestamp](https://www.unixtimestamp.com/) to retrieve all quotes modified before that time.

minModifiedintegerOptional

Enter a Unix timestamp to retrieve all quotes modified after that time.

Enter a [Unix timestamp](https://www.unixtimestamp.com/) to retrieve all quotes modified after that time.

maxExpiredintegerOptional

Enter a Unix timestamp to retrieve all quotes that expired before that time.

Enter a [Unix timestamp](https://www.unixtimestamp.com/) to retrieve all quotes that expired before that time.

minExpiredintegerOptional

Enter a Unix timestamp to retrieve all quotes that expired after that time.

Enter a [Unix timestamp](https://www.unixtimestamp.com/) to retrieve all quotes that expired after that time.

channelIds[]list of integersOptional

Enter one or more storefront channel IDs to retrieve quotes assigned to the storefront(s). Use 1 for your store’s default storefront channel. Separate channel IDs with a comma.

Response

A 200 response has a body with information on all quotes based on the provided parameters. If there are no quotes that correspond to the provided parameter values, the endpoint still returns a 200 response, but the data array is empty.

codedoubleDefaults to 200

HTTP Response Code

dataobject

messagestringDefaults to SUCCESS

metaobject

Errors

400

Bad Request Error

1	import requests
2
3	url = "https://api-b2b.bigcommerce.com/api/v3/io/rfq"
4
5	querystring = {"q":"Marie Curie","quoteNumber":"QN000035","company":"Great Buys Incorporated","salesRep":"Isaac Newton","status":"4","quoteTitle":"Plates - Custom Etching","createdBy":"Marie Curie","maxCreated":"1741376113","minCreated":"1741376113","maxModified":"1741376113","minModified":"1741376113","maxExpired":"1741376113","minExpired":"1741376113","channelIds[]":"[1]"}
6
7	headers = {"X-Auth-Token": "<apiKey>"}
8
9	response = requests.get(url, headers=headers, params=querystring)
10
11	print(response.json())

1	{
2	"data": {
3	"list": [
4	{
5	"quoteId": 123456,
6	"company": "Great Buys Incorporated",
7	"salesRep": "Isaac Newton",
8	"updatedAt": 1722619778,
9	"quoteNumber": "QN101234",
10	"status": 0,
11	"bcOrderId": "195",
12	"orderId": "112495",
13	"channelName": "b2B Store",
14	"createdAt": 1622619778,
15	"expiredAt": 1722619778,
16	"createdBy": "Marie Curie",
17	"subtotal": 1495,
18	"channelId": 1,
19	"quoteTitle": "Plates - Custom Etching",
20	"referenceNumber": "03302025-0001",
21	"currency": {
22	"token": "$",
23	"location": "left",
24	"currencyCode": "USD",
25	"decimalToken": ".",
26	"decimalPlaces": 2,
27	"thousandsToken": ",",
28	"currencyExchangeRate": 1.34
29	},
30	"extraFields": [
31	{
32	"fieldName": "I want a sales representative to call me at the provided phone number.",
33	"fieldValue": "Yes"
34	}
35	]
36	}
37	],
38	"pagination": {
39	"totalCount": 250,
40	"offset": 0,
41	"limit": 10
42	}
43	},
44	"message": "SUCCESS"
45	}