BigCommerce
Management API
Locations

Locations

Locations

By default, all BigCommerce stores have at least one location (id = 1). You can create additional locations to track inventory against using the /locations endpoints. Initially, we will only support the creation of physical inventory locations, which must have an address.

Metafields

Metafields allow you to add additional fields about your store's locations.

Create Locations

POST /inventory/locations

Request

Create new locations.

Authentication

  • X-Auth-Token in header - required

Parameters

  • store_hash in path - string
  • Content-Type in header with default of application/json - string - required

    The MIME type of the request body.

Body

array | application/json

  • code    string

    Location user-defined unique identifier.

    Example: BIGC-1

  • label    string

    Location label.

    Example: Central store

  • description    string

    Description of location. This field can be returned by the GraphQL Storefront API so that additional details can be exposed to customers on the storefront (customer-facing).

    Example: Central shop of the world

  • managed_by_external_source    boolean

    Indicates if the third-party system is the source of truth for inventory values. If set to true, manually editing inventory in BC's control panel will be disabled.

    Default: false

  • type_id    string

    Describe type of given location.

    Allowed: PHYSICAL | VIRTUAL

    Default: PHYSICAL

  • enabled    boolean

    Default: true

  • operating_hours    object

    Schedule with opening and closing hours for each day of the week.

  • time_zone    string

    Time zone of location. For a list of valid time zones, please view: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones.

    Example: Etc/UTC

  • address    object

    Address is required if the location's type_id is PHYSICAL.

  • storefront_visibility    boolean

    Default: true

  • special_hours    array[object]

Create Locations

Response

Locations have been successfully created.

Body

object | application/json

  • transaction_id    string

    Unique identifier of performed action.

example

Get Locations

GET /inventory/locations

Request

List locations. You can use optional filter parameters.

Authentication

  • X-Auth-Token in header - required

Parameters

  • store_hash in path - string
  • location_id:in in query - integer

    Comma separated list of location_id.

  • location_code:in in query - string

    Comma separated list of location_code.

  • is_default in query - boolean

    Filter whether the location is the default.

  • type_id:in in query - string

    Comma separated list of locations type codes.

  • managed_by_external_source in query - boolean

    Filter whether an external source manages location inventory levels.

  • is_active in query - boolean

    Filter by active locations flag; return both if not specified.

  • storefront_visibility in query - boolean

    Filter by storefront_visibility flag; return both if not specified.

  • page in query - integer

    Specifies the page number in a limited (paginated) list.

  • limit in query - integer

    Controls the number of items per page in a limited (paginated) list.

example

Response

The request has been successfully processed.

Body

object | application/json

  • data    array[object]

  • meta    object

example

Update Locations

PUT /inventory/locations

Request

Update existing locations.

Authentication

  • X-Auth-Token in header - required

Parameters

  • store_hash in path - string
  • Accept in header with default of application/json - string - required

    The MIME type of the response body.

Body

array | application/json

  • id    integer
    required

    Location immutable unique identifier.

    Example: 2

  • code    string

    Location user-defined unique identifier.

    Example: BIGC-2

  • label    string

    Location label.

    Example: Central store

  • description    string

    Description of location.

    Example: Central shop of the world

  • managed_by_external_source    boolean

    Indicates if the third-party system is the source of truth for inventory values. If set to true, manually editing inventory in BC's control panel will be disabled.

    Default: false

  • type_id    string

    Describe type of given location.

    Allowed: PHYSICAL | VIRTUAL

    Default: PHYSICAL

  • enabled    boolean

    Indicator of accessibility of the location.

    Default: true

  • operating_hours    object

    Schedule with opening and closing hours for each day of the week.

  • time_zone    string

    Time zone of location.

    Example: Etc/UTC

  • address    object

  • storefront_visibility    boolean

    Indicator of accessibility of location on the storefront.

    Default: true

  • special_hours    array[object]

Update Locations

Response

The request has been successfully processed.

Body

object | application/json

  • transaction_id    string

    Unique identifier of performed action.

example

Update Inventory Settings for a LocationCreate Locations