BigCommerce Docs

curl https://api.bigcommerce.com/stores/store_hash/v2/orders/1/shipping_addresses/1/shipping_quotes \
     -H "Accept: application/json" \
     -H "X-Auth-Token: <apiKey>" \
     -H "Content-Type: application/json"

{
  "id": "24",
  "uuid": "a72acc8d-504b-4a40-8534-7c54d997ed59",
  "timestamp": "Wed, 12 Apr 2023 10:15:30 +0000",
  "shipping_provider_id": "bcstatic",
  "shipping_provider_quote": [
    {
      "cost": {
        "amount": "12.99",
        "currency": "USD"
      },
      "estimatedDelivery": "3-5 business days",
      "service": "Standard Ground"
    }
  ],
  "provider_code": "shipping_byweight",
  "carrier_code": "fedex",
  "rate_code": "ground",
  "rate_id": "rate_123456",
  "method_id": 101
}

Gets all shipping quotes persisted on an order.

This is a read-only endpoint and the output can vary based on the shipping quote. A shipping quote can only be generated using the storefront at this time. Orders that are created in the control panel or using the API return a 204 for this endpoint since a shipping quote is not generated during that process.

Authentication

X-Auth-Tokenstring

OAuth scopes

UI Name	Permission	Parameter
Orders	modify	`store_v2_orders`
Orders	read-only	`store_v2_orders_read_only`

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.

### OAuth scopes | UI Name | Permission | Parameter | |:--------|:-----------|:----------| | Orders | modify | `store_v2_orders` | | Orders | read-only | `store_v2_orders_read_only` | ### 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#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).

Path parameters

order_idintegerRequired

ID of the order.

shipping_address_idintegerRequired

Shipping address ID.

store_hashstringRequired

Permanent ID of the BigCommerce store.

Response

This response can vary depending on the shipping provider.

idstringOptional

ID of the shipping quote.

uuidstringOptional

UUID of the shipping quote.

timestampstringOptional

Time the order was created in RFC 2822 format.

shipping_provider_idstringOptional

ID of the shipping provider.

shipping_provider_quotelist of objectsOptional

This can vary based on the shipping provider. Manual shipping methods such as fixed will return an empty array. Shipping providers such as UPS will return an object with the shipping information. Since the shipping quote is tied to a shipping address only one quote will return in the response.

provider_codestringOptional

Code of the shipping provider.

carrier_codestringOptional

Code of the shipping carrier.

rate_codestringOptional

Type of delivery. This can vary based on shipping quote.

rate_idstringOptional

This can vary based on shipping quote.

method_idintegerOptional

Shipping method ID

List Order Shipping Quotes

Authentication

OAuth scopes

Authentication header

Further reading

Path parameters

Headers

Response

OAuth scopes

Authentication header

Further reading