--- title: companyLocation - Customer API description: >- The Location corresponding to the provided ID. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data). api_version: 2025-07 api_name: customer type: query api_type: graphql source_url: html: 'https://shopify.dev/docs/api/customer/2025-07/queries/companyLocation' md: 'https://shopify.dev/docs/api/customer/2025-07/queries/companyLocation.md' --- # company​Location query The Location corresponding to the provided ID. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data). ## Arguments * id [ID!](https://shopify.dev/docs/api/customer/2025-07/scalars/ID) required The ID of the Location. *** ## Possible returns * Company​Location [Company​Location](https://shopify.dev/docs/api/customer/2025-07/objects/CompanyLocation) Represents a company's business location. * billing​Address [Company​Address](https://shopify.dev/docs/api/customer/2025-07/objects/CompanyAddress) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The billing address of the company location. * buyer​Experience​Configuration [Buyer​Experience​Configuration](https://shopify.dev/docs/api/customer/2025-07/objects/BuyerExperienceConfiguration) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The configuration of the buyer's B2B checkout. * contacts [Company​Contact​Connection!](https://shopify.dev/docs/api/customer/2025-07/connections/CompanyContactConnection) non-null The list of contacts under a particular business location. * first [Int](https://shopify.dev/docs/api/customer/2025-07/scalars/Int) ### Arguments The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * after [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String) The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * last [Int](https://shopify.dev/docs/api/customer/2025-07/scalars/Int) The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * before [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String) The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * reverse [Boolean](https://shopify.dev/docs/api/customer/2025-07/scalars/Boolean) Default:false Reverse the order of the underlying list. * sort​Key [Company​Contact​Sort​Keys](https://shopify.dev/docs/api/customer/2025-07/enums/CompanyContactSortKeys) Default:ID Sort the underlying list by the given key. * query [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String) A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about [Shopify API search syntax](https://shopify.dev/api/usage/search-syntax). * * default string * company\_id id - Filter by a case-insensitive search of multiple fields in a document. - Example: * `query=Bob Norman` * `query=title:green hoodie` * company\_location\_id id * created\_at time * email string * * id id * location\_name string - Filter by `id` range. - Example: * `id:1234` * `id:>=1234` * `id:<=1234` * name string * role\_name string * status string * updated\_at time *** * draft​Orders [Draft​Order​Connection!](https://shopify.dev/docs/api/customer/2025-07/connections/DraftOrderConnection) non-null The list of company draft orders. * first [Int](https://shopify.dev/docs/api/customer/2025-07/scalars/Int) ### Arguments The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * after [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String) The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * last [Int](https://shopify.dev/docs/api/customer/2025-07/scalars/Int) The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * before [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String) The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * reverse [Boolean](https://shopify.dev/docs/api/customer/2025-07/scalars/Boolean) Default:false Reverse the order of the underlying list. * sort​Key [Draft​Order​By​Location​Sort​Keys](https://shopify.dev/docs/api/customer/2025-07/enums/DraftOrderByLocationSortKeys) Default:ID Sort the underlying list using a key. If your query is slow or returns an error, then [try specifying a sort key that matches the field used in the search](https://shopify.dev/api/usage/pagination-graphql#search-performance-considerations). * query [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String) A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about [Shopify API search syntax](https://shopify.dev/api/usage/search-syntax). * * default string * company\_contact\_id id - Filter by a case-insensitive search of multiple fields in a document. - Example: * `query=Bob Norman` * `query=title:green hoodie` * created\_at time * customer\_id id * * id id * name string - Filter by `id` range. - Example: * `id:1234` * `id:>=1234` * `id:<=1234` * purchasing\_entity string * source string * status string * tag string * updated\_at time *** * external​Id [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A unique externally-supplied ID for the location. * id [ID!](https://shopify.dev/docs/api/customer/2025-07/scalars/ID) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A globally-unique ID. * metafield [Metafield](https://shopify.dev/docs/api/customer/2025-07/objects/Metafield) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) A metafield found by namespace and key. * namespace [String!](https://shopify.dev/docs/api/customer/2025-07/scalars/String) required ### Arguments A container for a set of metafields. * key [String!](https://shopify.dev/docs/api/customer/2025-07/scalars/String) required The identifier for the metafield. *** * metafields [\[Metafield\]!](https://shopify.dev/docs/api/customer/2025-07/objects/Metafield) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The metafields associated with the resource matching the supplied list of namespaces and keys. * identifiers [\[Has​Metafields​Identifier!\]!](https://shopify.dev/docs/api/customer/2025-07/input-objects/HasMetafieldsIdentifier) required ### Arguments The list of metafields to retrieve by namespace and key. *** * name [String!](https://shopify.dev/docs/api/customer/2025-07/scalars/String) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The name of the company location. * orders [Order​Connection!](https://shopify.dev/docs/api/customer/2025-07/connections/OrderConnection) non-null The list of customer orders under the company. * first [Int](https://shopify.dev/docs/api/customer/2025-07/scalars/Int) ### Arguments The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * after [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String) The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * last [Int](https://shopify.dev/docs/api/customer/2025-07/scalars/Int) The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * before [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String) The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * reverse [Boolean](https://shopify.dev/docs/api/customer/2025-07/scalars/Boolean) Default:false Reverse the order of the underlying list. * sort​Key [Order​By​Location​Sort​Keys](https://shopify.dev/docs/api/customer/2025-07/enums/OrderByLocationSortKeys) Default:ID Sort the underlying list using a key. If your query is slow or returns an error, then [try specifying a sort key that matches the field used in the search](https://shopify.dev/api/usage/pagination-graphql#search-performance-considerations). * query [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String) A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about [Shopify API search syntax](https://shopify.dev/api/usage/search-syntax). * * default string * confirmation\_number string - Filter by a case-insensitive search of multiple fields in a document. - Example: * `query=Bob Norman` * `query=title:green hoodie` * created\_at time * * id id * name string - Filter by `id` range. - Example: * `id:1234` * `id:>=1234` * `id:<=1234` * order\_number string * processed\_at time * purchasing\_company\_contact\_id id * purchasing\_company\_id id * purchasing\_company\_location\_id id * purchasing\_entity string * shipment\_status string * updated\_at time *** * role​Assignments [Company​Contact​Role​Assignment​Connection!](https://shopify.dev/docs/api/customer/2025-07/connections/CompanyContactRoleAssignmentConnection) non-null The list of roles assigned to this location. * first [Int](https://shopify.dev/docs/api/customer/2025-07/scalars/Int) ### Arguments The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * after [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String) The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * last [Int](https://shopify.dev/docs/api/customer/2025-07/scalars/Int) The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * before [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String) The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * reverse [Boolean](https://shopify.dev/docs/api/customer/2025-07/scalars/Boolean) Default:false Reverse the order of the underlying list. * sort​Key [Company​Contact​Role​Assignment​Sort​Keys](https://shopify.dev/docs/api/customer/2025-07/enums/CompanyContactRoleAssignmentSortKeys) Default:ID Sort the underlying list by the given key. * query [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String) A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about [Shopify API search syntax](https://shopify.dev/api/usage/search-syntax). * * default string * company\_contact\_id id - Filter by a case-insensitive search of multiple fields in a document. - Example: * `query=Bob Norman` * `query=title:green hoodie` * company\_contact\_role\_id id * company\_id id * company\_location\_id id * created\_at time * * id id * location\_name string - Filter by `id` range. - Example: * `id:1234` * `id:>=1234` * `id:<=1234` * role\_name string * updated\_at time *** * shipping​Address [Company​Address](https://shopify.dev/docs/api/customer/2025-07/objects/CompanyAddress) [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The shipping address of the company location. * tax​Identifier [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String) The tax id of the company location. * market [Market!](https://shopify.dev/docs/api/customer/2025-07/objects/Market) non-nullDeprecated[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) *** ## Examples * ### companyLocation reference