> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# Get Locations

You can query location information using the GraphQL Storefront API. The information accessible by any storefront API is controlled by the [location settings](#location-settings) for the store.

For example queries, see [Query Locations with the GraphQL Storefront API](/developer/docs/storefront/guides/graphql-storefront-api/locations/queries).

To work with locations, the [API account](/developer/docs/overview/api-fundamentals/api-accounts#api-accounts) that generates [Storefront tokens](/developer/api-reference/rest/admin/authentication-apis/storefront-api-tokens) must include one of the following [OAuth scopes](/developer/docs/overview/api-fundamentals/api-accounts#oauth-scopes):

| UI Name                | Permission | Parameter                        |
| :--------------------- | :--------- | :------------------------------- |
| Information & Settings | modify     | `store_v2_information`           |
| Information & Settings | read-only  | `store_v2_information_read_only` |

Use these scopes to read and change the following information:

* The storefront details for a location
* General store information
* Location addresses
* Contact details

> **Note**
>
> The *Buy Online, Pick up in Store* pattern is designed to center a single online storefront. *Buy Online, Pick up in Store* is not compatible with multi-storefront channels (MSF).

## Location settings

A location must be *enabled* and *visible* in order for the GraphQL Storefront API to storefront details for the location.

If a location is not enabled or visible, send a request to the [Update Locations](/developer/api-reference/rest/admin/management/inventory/locations/update-locations) endpoint.

**`Example request: Update location`**

```http title="Example request: Update location" showLineNumbers={false}
PUT https://api.bigcommerce.com/stores/{{store_hash}}/v3/inventory/locations
X-Auth-Token: {{access_token}}
Content-Type: application/json
Accept: application/json

[
  {
    "id": 2,
    "enabled": true,
    "storefront_visibility": true
  }
]  
```

## Resources

* [GraphQL Storefront API Overview](/developer/docs/storefront/guides/graphql-storefront-api)
* [GraphQL Storefront API Reference](/developer/docs/storefront/guides/graphql-storefront-api)
* [GraphQL Storefront Playground](/developer/api-reference/rest/storefront/overview)
* [GraphQL Storefront Explorer](/developer/api-reference/rest/storefront/overview)