--- title: CompanyLocation - Customer API description: Represents a company's business location. api_version: 2026-10 source_url: html: 'https://shopify.dev/docs/api/customer/latest/objects/CompanyLocation' md: 'https://shopify.dev/docs/api/customer/latest/objects/CompanyLocation.md' api_name: customer api_type: graphql type: object --- # Company​Location object Requires `customer_read_customers` access scope or `customer_read_companies` access scope. Represents a company's business location. ## Fields * billing​Address [Company​Address](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress) The billing address of the company location. * buyer​Experience​Configuration [Buyer​Experience​Configuration](https://shopify.dev/docs/api/customer/latest/objects/BuyerExperienceConfiguration) The configuration of the buyer's B2B checkout. * contacts [Company​Contact​Connection!](https://shopify.dev/docs/api/customer/latest/connections/CompanyContactConnection) non-null The list of contacts under a particular business location. * after [String](https://shopify.dev/docs/api/customer/latest/scalars/String) ### Arguments The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * before [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * first [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int) The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * last [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int) The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * query [String](https://shopify.dev/docs/api/customer/latest/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 * reverse [Boolean](https://shopify.dev/docs/api/customer/latest/scalars/Boolean) Default:false Reverse the order of the underlying list. * sort​Key [Company​Contact​Sort​Keys](https://shopify.dev/docs/api/customer/latest/enums/CompanyContactSortKeys) Default:ID Sort the underlying list by the given key. *** * draft​Orders [Draft​Order​Connection!](https://shopify.dev/docs/api/customer/latest/connections/DraftOrderConnection) non-null The list of company draft orders. * after [String](https://shopify.dev/docs/api/customer/latest/scalars/String) ### Arguments The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * before [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * first [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int) The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * last [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int) The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * query [String](https://shopify.dev/docs/api/customer/latest/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 * reverse [Boolean](https://shopify.dev/docs/api/customer/latest/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/latest/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). *** * external​Id [String](https://shopify.dev/docs/api/customer/latest/scalars/String) A unique externally-supplied ID for the location. * id [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID) non-null A globally-unique ID. * market​Currency​Code [Currency​Code!](https://shopify.dev/docs/api/customer/latest/enums/CurrencyCode) non-null The currency for the company location's market, derived from the location's shipping address. When the location has no shipping address, or no market currency matches the address, this falls back to the shop's currency. Use it to choose which store credit balance to present as the primary one. * metafield [Metafield](https://shopify.dev/docs/api/customer/latest/objects/Metafield) A metafield found by namespace and key. * key [String!](https://shopify.dev/docs/api/customer/latest/scalars/String) required ### Arguments The identifier for the metafield. * namespace [String!](https://shopify.dev/docs/api/customer/latest/scalars/String) required A container for a set of metafields. *** * metafields [\[Metafield\]!](https://shopify.dev/docs/api/customer/latest/objects/Metafield) non-null The metafields associated with the resource matching the supplied list of namespaces and keys. * identifiers [\[Has​Metafields​Identifier!\]!](https://shopify.dev/docs/api/customer/latest/input-objects/HasMetafieldsIdentifier) required ### Arguments The list of metafields to retrieve by namespace and key. *** * name [String!](https://shopify.dev/docs/api/customer/latest/scalars/String) non-null The name of the company location. * orders [Order​Connection!](https://shopify.dev/docs/api/customer/latest/connections/OrderConnection) non-null The list of customer orders under the company. * after [String](https://shopify.dev/docs/api/customer/latest/scalars/String) ### Arguments The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * before [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * first [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int) The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * last [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int) The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * query [String](https://shopify.dev/docs/api/customer/latest/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 * reverse [Boolean](https://shopify.dev/docs/api/customer/latest/scalars/Boolean) Default:false Reverse the order of the underlying list. * sort​Key [Order​By​Location​Sort​Keys](https://shopify.dev/docs/api/customer/latest/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). *** * role​Assignments [Company​Contact​Role​Assignment​Connection!](https://shopify.dev/docs/api/customer/latest/connections/CompanyContactRoleAssignmentConnection) non-null The list of roles assigned to this location. * after [String](https://shopify.dev/docs/api/customer/latest/scalars/String) ### Arguments The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * before [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * first [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int) The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * last [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int) The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * query [String](https://shopify.dev/docs/api/customer/latest/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 * reverse [Boolean](https://shopify.dev/docs/api/customer/latest/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/latest/enums/CompanyContactRoleAssignmentSortKeys) Default:ID Sort the underlying list by the given key. *** * shipping​Address [Company​Address](https://shopify.dev/docs/api/customer/latest/objects/CompanyAddress) The shipping address of the company location. * store​Credit​Accounts [Store​Credit​Account​Connection!](https://shopify.dev/docs/api/customer/latest/connections/StoreCreditAccountConnection) non-null A list of the owner resource's store credit accounts. Store credit accounts are not shown for shops with store credit disabled at checkout. * after [String](https://shopify.dev/docs/api/customer/latest/scalars/String) ### Arguments The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * before [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * first [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int) The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * last [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int) The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * query [String](https://shopify.dev/docs/api/customer/latest/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). * currency\_code string * id id Filter by `id` range. Example: * `id:1234` * `id:>=1234` * `id:<=1234` *** * tax​Identifier [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The tax id of the company location. * market [Market!](https://shopify.dev/docs/api/customer/latest/objects/Market) non-nullDeprecated *** ## Map ### Fields and connections with this object * [Company.locations](https://shopify.dev/docs/api/customer/latest/objects/Company#field-Company.fields.locations) * [CompanyContact.locations](https://shopify.dev/docs/api/customer/latest/objects/CompanyContact#field-CompanyContact.fields.locations) * [CompanyLocationConnection.nodes](https://shopify.dev/docs/api/customer/latest/connections/CompanyLocationConnection#returns-nodes) * [CompanyLocationEdge.node](https://shopify.dev/docs/api/customer/latest/objects/CompanyLocationEdge#field-CompanyLocationEdge.fields.node) * [PurchasingCompany.location](https://shopify.dev/docs/api/customer/latest/objects/PurchasingCompany#field-PurchasingCompany.fields.location) *** ## Queries * [company​Location](https://shopify.dev/docs/api/customer/latest/queries/companyLocation) 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). * id [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID) required ### Arguments The ID of the Location. *** *** ## CompanyLocation Queries ### Queried by * [company​Location](https://shopify.dev/docs/api/customer/latest/queries/companyLocation) *** ## Interfaces * * [Has​Metafields](https://shopify.dev/docs/api/customer/latest/interfaces/HasMetafields) interface * [Has​Store​Credit​Accounts](https://shopify.dev/docs/api/customer/latest/interfaces/HasStoreCreditAccounts) interface * [Node](https://shopify.dev/docs/api/customer/latest/interfaces/Node) interface *** ## CompanyLocation Implements ### Implements * [Has​Metafields](https://shopify.dev/docs/api/customer/latest/interfaces/HasMetafields) * [Has​Store​Credit​Accounts](https://shopify.dev/docs/api/customer/latest/interfaces/HasStoreCreditAccounts) * [Node](https://shopify.dev/docs/api/customer/latest/interfaces/Node)