# Business Units Business Units are representations of Companies or Divisions. They allow you to model the structure of a business and the access rights of its users. Business Units can have a set of Associates assigned to them. Associates are represented as [Customers](https://docs.commercetools.com/api/projects/customers.md) that hold different [Associate Roles](https://docs.commercetools.com/api/projects/associate-roles.md#associaterole). The Associate Roles are used to grant Associates different permissions. Business Units can be organized hierarchically up to a maximum of 5 levels, with the top level being a Business Unit of type Company. Divisions can support inheritance, which allows them to inherit [Stores](https://docs.commercetools.com/api/projects/business-units.md#businessunitstoremode), [Associates and their roles](https://docs.commercetools.com/api/projects/business-units.md#businessunitassociatemode), and [Approval Rules](https://docs.commercetools.com/api/projects/business-units.md#businessunitapprovalrulemode) from parent units higher up in the hierarchy. This is a soft limit that can be increased per Project after a performance impact review. See [Limit increase guidance](https://docs.commercetools.com/api/limit-increase-guidance.md#b2b-hierarchy-and-permission-limits). [Carts](https://docs.commercetools.com/api/projects/carts.md), [Orders](https://docs.commercetools.com/api/projects/orders.md), [Recurring Orders](https://docs.commercetools.com/api/projects/recurring-orders.md), [Quotes](https://docs.commercetools.com/api/quotes-overview.md), [Quote Requests](https://docs.commercetools.com/api/projects/quote-requests.md), and [Shopping Lists](https://docs.commercetools.com/api/projects/shoppingLists.md) can reference Business Units. Business Units can be used to model [company-specific products, pricing, and discounts](https://docs.commercetools.com/api/customers-overview.md#customer-specific-products-prices-and-discounts) with the help of [Stores](https://docs.commercetools.com/api/projects/stores.md), [Product Selections](https://docs.commercetools.com/api/projects/product-selections.md), and [Channels](https://docs.commercetools.com/api/projects/channels.md). ## Representations #### BusinessUnit See API type definition [BusinessUnit](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnit). ##### Company See API type definition [Company](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ACompany). ##### Division See API type definition [Division](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ADivision). #### BusinessUnitDraft See API type definition [BusinessUnitDraft](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitDraft). ##### CompanyDraft See API type definition [CompanyDraft](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ACompanyDraft). ##### DivisionDraft See API type definition [DivisionDraft](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ADivisionDraft). #### Associate See API type definition [Associate](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3AAssociate). #### AssociateDraft See API type definition [AssociateDraft](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3AAssociateDraft). #### AssociateRoleAssignment See API type definition [AssociateRoleAssignment](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3AAssociateRoleAssignment). #### AssociateRoleAssignmentDraft See API type definition [AssociateRoleAssignmentDraft](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3AAssociateRoleAssignmentDraft). #### AssociateRoleInheritanceMode See API type definition [AssociateRoleInheritanceMode](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3AAssociateRoleInheritanceMode). #### InheritedAssociate See API type definition [InheritedAssociate](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3AInheritedAssociate). #### InheritedAssociateRoleAssignment See API type definition [InheritedAssociateRoleAssignment](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3AInheritedAssociateRoleAssignment). #### BusinessUnitStatus See API type definition [BusinessUnitStatus](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitStatus). #### BusinessUnitType See API type definition [BusinessUnitType](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitType). #### BusinessUnitAssociateMode See API type definition [BusinessUnitAssociateMode](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitAssociateMode). #### BusinessUnitApprovalRuleMode See API type definition [BusinessUnitApprovalRuleMode](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitApprovalRuleMode). #### BusinessUnitStoreMode See API type definition [BusinessUnitStoreMode](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitStoreMode). #### BusinessUnitPagedQueryResponse See API type definition [BusinessUnitPagedQueryResponse](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitPagedQueryResponse). #### BusinessUnitReference See API type definition [BusinessUnitReference](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitReference). #### BusinessUnitKeyReference See API type definition [BusinessUnitKeyReference](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitKeyReference). #### BusinessUnitResourceIdentifier See API type definition [BusinessUnitResourceIdentifier](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitResourceIdentifier). #### BusinessUnitAssociateResponse See API type definition [BusinessUnitAssociateResponse](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitAssociateResponse). ## Get BusinessUnit ### Get BusinessUnit by ID See API endpoint definition [GET /\{projectKey}/business-units/\{id}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fbusiness-units%2F%7Bid%7D%3AGET). ### Get BusinessUnit by Key See API endpoint definition [GET /\{projectKey}/business-units/key=\{key}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fbusiness-units%2Fkey%3D%7Bkey%7D%3AGET). ## Get Associate in BusinessUnit ### Get Associate in BusinessUnit by ID See API endpoint definition [GET /\{projectKey}/business-units/\{businessUnitId}/associates/\{associateId}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fbusiness-units%2F%7BbusinessUnitId%7D%2Fassociates%2F%7BassociateId%7D%3AGET). ### Get Associate in BusinessUnit by Key See API endpoint definition [GET /\{projectKey}/business-units/key=\{key}/associates/\{associateId}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fbusiness-units%2Fkey%3D%7Bkey%7D%2Fassociates%2F%7BassociateId%7D%3AGET). ## Get BusinessUnit in Store ### Get BusinessUnit in Store by ID See API endpoint definition [GET /\{projectKey}/in-store/key=\{storeKey}/business-units/\{id}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fbusiness-units%2F%7Bid%7D%3AGET). ### Get BusinessUnit in Store by Key See API endpoint definition [GET /\{projectKey}/in-store/key=\{storeKey}/business-units/key=\{key}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fbusiness-units%2Fkey%3D%7Bkey%7D%3AGET). ## Get Associate in BusinessUnit in Store ### Get Associate in BusinessUnit in Store by ID See API endpoint definition [GET /\{projectKey}/in-store/key=\{storeKey}/business-units/\{businessUnitId}/associates/\{associateId}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fbusiness-units%2F%7BbusinessUnitId%7D%2Fassociates%2F%7BassociateId%7D%3AGET). ### Get Associate in BusinessUnit in Store by Key See API endpoint definition [GET /\{projectKey}/in-store/key=\{storeKey}/business-units/key=\{key}/associates/\{associateId}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fbusiness-units%2Fkey%3D%7Bkey%7D%2Fassociates%2F%7BassociateId%7D%3AGET). ## Query BusinessUnits See API endpoint definition [GET /\{projectKey}/business-units](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fbusiness-units%3AGET). ## Query BusinessUnits in Store See API endpoint definition [GET /\{projectKey}/in-store/key=\{storeKey}/business-units](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fbusiness-units%3AGET). ## Check if BusinessUnit exists ### Check if BusinessUnit exists by ID See API endpoint definition [HEAD /\{projectKey}/business-units/\{id}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fbusiness-units%2F%7Bid%7D%3AHEAD). ### Check if BusinessUnit exists by Key See API endpoint definition [HEAD /\{projectKey}/business-units/key=\{key}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fbusiness-units%2Fkey%3D%7Bkey%7D%3AHEAD). ### Check if BusinessUnit exists by Query Predicate See API endpoint definition [HEAD /\{projectKey}/business-units](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fbusiness-units%3AHEAD). ## Check if BusinessUnit exists in Store ### Check if BusinessUnit exists in Store by ID See API endpoint definition [HEAD /\{projectKey}/in-store/key=\{storeKey}/business-units/\{id}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fbusiness-units%2F%7Bid%7D%3AHEAD). ### Check if BusinessUnit exists in Store by Key See API endpoint definition [HEAD /\{projectKey}/in-store/key=\{storeKey}/business-units/key=\{key}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fbusiness-units%2Fkey%3D%7Bkey%7D%3AHEAD). ### Check if BusinessUnit exists in Store by Query Predicate See API endpoint definition [HEAD /\{projectKey}/in-store/key=\{storeKey}/business-units](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fbusiness-units%3AHEAD). ## Create BusinessUnit Creating a Business Unit produces the [BusinessUnitCreated](https://docs.commercetools.com/api/projects/messages/business-unit-associate-role-messages.md#business-unit-created) Message. See API endpoint definition [POST /\{projectKey}/business-units](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fbusiness-units%3APOST). ## Create BusinessUnit in Store Creating a Business Unit produces the [BusinessUnitCreated](https://docs.commercetools.com/api/projects/messages/business-unit-associate-role-messages.md#business-unit-created) Message. See API endpoint definition [POST /\{projectKey}/in-store/key=\{storeKey}/business-units](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fbusiness-units%3APOST). ## Update BusinessUnit ### Update BusinessUnit by ID See API endpoint definition [POST /\{projectKey}/business-units/\{id}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fbusiness-units%2F%7Bid%7D%3APOST). ### Update BusinessUnit by Key See API endpoint definition [POST /\{projectKey}/business-units/key=\{key}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fbusiness-units%2Fkey%3D%7Bkey%7D%3APOST). ## Update BusinessUnit in Store ### Update BusinessUnit in Store by ID See API endpoint definition [POST /\{projectKey}/in-store/key=\{storeKey}/business-units/\{id}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fbusiness-units%2F%7Bid%7D%3APOST). ### Update BusinessUnit in Store by Key See API endpoint definition [POST /\{projectKey}/in-store/key=\{storeKey}/business-units/key=\{key}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fbusiness-units%2Fkey%3D%7Bkey%7D%3APOST). ## Update actions #### Add Address See API type definition [BusinessUnitAddAddressAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitAddAddressAction). #### Add Associate To add Associates in bulk to Business Units, use the [Set Associates](https://docs.commercetools.com/api/projects/business-units.md#set-associates) action instead. See API type definition [BusinessUnitAddAssociateAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitAddAssociateAction). #### Add CustomerGroupAssignment See API type definition [BusinessUnitAddCustomerGroupAssignmentAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitAddCustomerGroupAssignmentAction). #### Add Billing Address Identifier See API type definition [BusinessUnitAddBillingAddressIdAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitAddBillingAddressIdAction). #### Add Shipping Address Identifier See API type definition [BusinessUnitAddShippingAddressIdAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitAddShippingAddressIdAction). #### Add Store See API type definition [BusinessUnitAddStoreAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitAddStoreAction). #### Change Address See API type definition [BusinessUnitChangeAddressAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitChangeAddressAction). #### Change Associate See API type definition [BusinessUnitChangeAssociateAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitChangeAssociateAction). #### Change Associate Mode See API type definition [BusinessUnitChangeAssociateModeAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitChangeAssociateModeAction). #### Change Approval Rule Mode See API type definition [BusinessUnitChangeApprovalRuleModeAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitChangeApprovalRuleModeAction). #### Change Name See API type definition [BusinessUnitChangeNameAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitChangeNameAction). #### Change Parent Unit You can organize Business Units hierarchically up to 5 levels. Each top-level unit can include up to 4000 Divisions, including direct and indirect children. See API type definition [BusinessUnitChangeParentUnitAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitChangeParentUnitAction). You can perform only one hierarchy move operation at a time. If another `changeParentUnit` or `setUnitType` update action is performed simultaneously, a [ConcurrentModification](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3AConcurrentModificationError) error is returned. The error is also returned if the BusinessUnit `topLevelUnit` field is being updated asynchronously in the background, as it is [eventually consistent](https://docs.commercetools.com/api/general-concepts.md#eventual-consistency). #### Set Unit Type This update action is not available via the Me or as-associate API. You can organize Business Units hierarchically up to 5 levels. Each top-level unit can include up to 4000 Divisions, including direct and indirect children. See API type definition [BusinessUnitSetUnitTypeAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitSetUnitTypeAction). You can perform only one hierarchy move operation at a time. If another `changeParentUnit` or `setUnitType` update action is performed simultaneously, a [ConcurrentModification](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3AConcurrentModificationError) error is returned. The error is also returned if the BusinessUnit `topLevelUnit` field is being updated asynchronously in the background, as it is [eventually consistent](https://docs.commercetools.com/api/general-concepts.md#eventual-consistency). #### Change Status See API type definition [BusinessUnitChangeStatusAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitChangeStatusAction). #### Remove Address See API type definition [BusinessUnitRemoveAddressAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitRemoveAddressAction). #### Remove Associate See API type definition [BusinessUnitRemoveAssociateAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitRemoveAssociateAction). #### Remove CustomerGroupAssignment See API type definition [BusinessUnitRemoveCustomerGroupAssignmentAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitRemoveCustomerGroupAssignmentAction). #### Remove Store See API type definition [BusinessUnitRemoveStoreAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitRemoveStoreAction). #### Remove Billing Address Identifier See API type definition [BusinessUnitRemoveBillingAddressIdAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitRemoveBillingAddressIdAction). #### Remove Shipping Address Identifier See API type definition [BusinessUnitRemoveShippingAddressIdAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitRemoveShippingAddressIdAction). #### Set Address CustomField See API type definition [BusinessUnitSetAddressCustomFieldAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitSetAddressCustomFieldAction). #### Set Associates See API type definition [BusinessUnitSetAssociatesAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitSetAssociatesAction). #### Set Custom Type in Address See API type definition [BusinessUnitSetAddressCustomTypeAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitSetAddressCustomTypeAction). #### Set Contact Email See API type definition [BusinessUnitSetContactEmailAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitSetContactEmailAction). #### Set CustomerGroupAssignments See API type definition [BusinessUnitSetCustomerGroupAssignmentsAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitSetCustomerGroupAssignmentsAction). #### Set CustomField See API type definition [BusinessUnitSetCustomFieldAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitSetCustomFieldAction). #### Set Custom Type See API type definition [BusinessUnitSetCustomTypeAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitSetCustomTypeAction). #### Set Default Billing Address See API type definition [BusinessUnitSetDefaultBillingAddressAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitSetDefaultBillingAddressAction). #### Set Default Shipping Address See API type definition [BusinessUnitSetDefaultShippingAddressAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitSetDefaultShippingAddressAction). #### Set Stores See API type definition [BusinessUnitSetStoresAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitSetStoresAction). #### Set Store Mode See API type definition [BusinessUnitSetStoreModeAction](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Atype%3ABusinessUnitSetStoreModeAction). ## Delete BusinessUnit Deleting a Business Unit produces the [BusinessUnitDeleted](https://docs.commercetools.com/api/projects/messages/business-unit-associate-role-messages.md#business-unit-deleted) Message. A Business Unit can only be deleted if it is not referenced by a [Cart](https://docs.commercetools.com/api/projects/carts.md), [Order](https://docs.commercetools.com/api/projects/orders.md), [Quote](https://docs.commercetools.com/api/projects/quotes.md), [Shopping List](https://docs.commercetools.com/api/projects/shoppingLists.md), or another Business Unit. ### Delete BusinessUnit by ID See API endpoint definition [DELETE /\{projectKey}/business-units/\{id}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fbusiness-units%2F%7Bid%7D%3ADELETE). ### Delete BusinessUnit by Key See API endpoint definition [DELETE /\{projectKey}/business-units/key=\{key}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fbusiness-units%2Fkey%3D%7Bkey%7D%3ADELETE). ## Delete BusinessUnit in Store Deleting a Business Unit produces the [BusinessUnitDeleted](https://docs.commercetools.com/api/projects/messages/business-unit-associate-role-messages.md#business-unit-deleted) Message. A Business Unit can only be deleted if it is not referenced by a [Cart](https://docs.commercetools.com/api/projects/carts.md), [Order](https://docs.commercetools.com/api/projects/orders.md), [Quote](https://docs.commercetools.com/api/projects/quotes.md), or another Business Unit. ### Delete BusinessUnit in Store by ID See API endpoint definition [DELETE /\{projectKey}/in-store/key=\{storeKey}/business-units/\{id}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fbusiness-units%2F%7Bid%7D%3ADELETE). ### Delete BusinessUnit in Store by Key See API endpoint definition [DELETE /\{projectKey}/in-store/key=\{storeKey}/business-units/key=\{key}](https://docs.commercetools.com/api/projects/business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fbusiness-units%2Fkey%3D%7Bkey%7D%3ADELETE). ## GraphQL query fields In addition to the fields available on the REST API, the GraphQL API for Business Units supports two additional fields: `ancestors` and `inheritedStores`. ### Ancestors The `ancestors` field returns a list of all the parent Business Units of the queried Business Unit. The list is ordered from the top-level Company to the parent unit of the Business Unit. ```json query { businessUnit(key: "sub-division") { ancestors { key name contactEmail status } } } ``` ### Inherited Stores The `inheritedStores` field returns a list of the Stores a Business Unit inherits from its parent. For a Company, or a Division with `storeMode` set to `Explicit`, this field is null. ```json query { businessUnit(key: "sub-division") { inheritedStores { store { key supplyChannels { id key roles } } } } } ``` ## Related pages - [Section overview page](https://docs.commercetools.com/api.md) - [Previous page: Overview](https://docs.commercetools.com/api/associates-overview.md) - [Next page: Business Unit Search](https://docs.commercetools.com/api/projects/business-unit-search.md)