---
title: BusinessEntity - GraphQL Admin
description: >-
  A legal entity through which a merchant operates. Each business entity
  contains its own
  [`BusinessEntityAddress`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BusinessEntityAddress),
  company information, and can be associated with its own
  [`ShopifyPaymentsAccount`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsAccount).
  [`Market`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Market)
  objects can be assigned to a business entity to determine payment processing
  and [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order)
  attribution.


  Every shop must have one primary business entity. Additional entities enable
  international operations by establishing legal presence in multiple countries.


  Learn more about [managing multiple legal
  entities](https://shopify.dev/docs/apps/build/markets/multiple-entities).
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/BusinessEntity'
  md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/BusinessEntity.md'
---

# Business​Entity

object

A legal entity through which a merchant operates. Each business entity contains its own [`BusinessEntityAddress`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BusinessEntityAddress), company information, and can be associated with its own [`ShopifyPaymentsAccount`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsAccount). [`Market`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Market) objects can be assigned to a business entity to determine payment processing and [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) attribution.

Every shop must have one primary business entity. Additional entities enable international operations by establishing legal presence in multiple countries.

Learn more about [managing multiple legal entities](https://shopify.dev/docs/apps/build/markets/multiple-entities).

## Fields

* address
* archived
* companyName
* displayName
* id
* primary
* shopifyPaymentsAccount

***

## Map

### Fields with this object

* [Order.merchantBusinessEntity](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order#field-Order.fields.merchantBusinessEntity)
* [ShopifyPaymentsPayout.businessEntity](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsPayout#field-ShopifyPaymentsPayout.fields.businessEntity)

***

## Queries

* businessEntities
* businessEntity

***

## BusinessEntity Queries

### Queried by

* [business​Entities](https://shopify.dev/docs/api/admin-graphql/latest/queries/businessEntities)
* [business​Entity](https://shopify.dev/docs/api/admin-graphql/latest/queries/businessEntity)

***

## Interfaces

* Node

***

## BusinessEntity Implements

### Implements

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)