Shipping Zones
Get All Shipping Zones
GET https://api.bigcommerce.com/stores/{store_hash}/v2/shipping/zonesRequest
Returns a list of all Shipping Zones.
Authentication
- X-Auth-Token in headerrequired
Parameters
- store_hash in path - string
example
Response
Body
idinteger
Zone ID
Example: 1namestring
Zone name. Required for PUT requests.
Example: United Statestypestring
Allowed: zip | country | state | global
locationsarray[object]
Array of zone locations.
free_shippingobject
handling_fees
Any of:Percentage surcharge fixed_surchargestring
Flat-rate handling fee applied to shipping cost.
Example: 0display_separatelyboolean
Indicates whether store displays handling fee separately at checkout.
Example: true
enabledboolean
Whether this shipping zone is enabled.
Example: true
Example 1: Zones are Country Zones
Example 2: Zone is Selection of States in a Country
Create a Shipping Zone
Request
Creates a Shipping Zone.
Authentication
- X-Auth-Token in headerrequired
Show details
Parameters
- store_hash in path - string
Body
namestring
requiredZone name. Required for PUT requests.
Example: United Statestypestring
requiredAllowed: zip | country | state | global
locationsarray[object] Array of zone locations.
free_shippingobject handling_fees
Any of:Fixed surcharge Percentage surcharge fixed_surchargestring
Flat-rate handling fee applied to shipping cost.
Example: 0display_separatelyboolean
Indicates whether store displays handling fee separately at checkout.
Example: true
enabledboolean
Whether this shipping zone is enabled.
Example: true
Type: ZIP
Type: Country
Type: State
Type: Global
Response
Body
idinteger
Zone ID.
Example: 1namestring
Zone name.
Example: United Statestypestring
Allowed: zip | country | state | global
locationsarray[object] Array of zone locations.
free_shippingobject handling_fees
Any of:Fixed surcharge Percentage surcharge fixed_surchargestring
Flat-rate handling fee applied to shipping cost.
Example: 0display_separatelyboolean
Indicates whether store displays handling fee separately at checkout.
Example: true
enabledboolean
Whether this shipping zone is enabled.
Example: true
Get a Shipping Zones
Request
Returns a single Shipping Zone.
Authentication
- X-Auth-Token in headerrequired
Show details
Parameters
- store_hash in path - string
- id in path - integerrequired
ID of the shipping zone.
example
Response
Body
idinteger
Zone ID
Example: 1namestring
Zone name.
Example: United Statestypestring
Allowed: zip | country | state | global
locationsarray[object] Array of zone locations.
free_shippingobject handling_fees
Any of:Fixed surcharge Percentage surcharge fixed_surchargestring
Flat-rate handling fee applied to shipping cost.
Example: 0display_separatelyboolean
Indicates whether store displays handling fee separately at checkout.
Example: true
enabledboolean
Whether this shipping zone is enabled.
Example: true
example
Update a Shipping Zone
Request
Updates a Shipping Zone.
Required Fields
- name
Read Only Fields
- id
Authentication
- X-Auth-Token in headerrequired
Show details
Parameters
- store_hash in path - string
- id in path - integerrequired
ID of the shipping zone.
Body
idinteger
read-onlyZone ID. Read-only.
Example: 1namestring
requiredZone name. Required for PUT requests.
Example: United Statestypestring
Allowed: zip | country | state | global
locationsarray[object] Array of zone locations.
free_shippingobject handling_fees
Any of:Fixed surcharge Percentage surcharge fixed_surchargestring
Flat-rate handling fee applied to shipping cost.
Example: 0display_separatelyboolean
Indicates whether store displays handling fee separately at checkout.
Example: true
enabledboolean
Whether this shipping zone is enabled.
Example: true
example
Response
Body
idinteger
read-onlyZone ID. Read-only.
Example: 1namestring
requiredZone name. Required for PUT requests.
Example: United Statestypestring
Allowed: zip | country | state | global
locationsarray[object] Array of zone locations.
free_shippingobject handling_fees
Any of:Fixed surcharge Percentage surcharge fixed_surchargestring
Flat-rate handling fee applied to shipping cost.
Example: 0display_separatelyboolean
Indicates whether store displays handling fee separately at checkout.
Example: true
enabledboolean
Whether this shipping zone is enabled.
Example: true
example
Delete a Shipping Zone
Request
Deletes a Shipping Zone.
Authentication
- X-Auth-Token in headerrequired
Show details
Parameters
- store_hash in path - string
- id in path - integerrequired
ID of the shipping zone.