---
title: Company - GraphQL Admin
description: >-
  A business entity that purchases from the shop as part of B2B commerce.
  Companies organize multiple locations and contacts who can place orders on
  behalf of the organization.
  [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocation)
  objects can have custom pricing through
  [`Catalog`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Catalog)
  and
  [`PriceList`](https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceList)
  configurations.
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Company'
  md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Company.md'
---

# Company

object

Requires `read_customers` access scope or `read_companies` access scope. Also: The API client must be installed on a Shopify Plus store.

A business entity that purchases from the shop as part of B2B commerce. Companies organize multiple locations and contacts who can place orders on behalf of the organization. [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocation) objects can have custom pricing through [`Catalog`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Catalog) and [`PriceList`](https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceList) configurations.

## Fields

* contactRoles
* contacts
* contactsCount
* createdAt
* customerSince
* defaultCursor
* defaultRole
* draftOrders
* events
* externalId
* hasTimelineComment
* id
* lifetimeDuration
* locations
* locationsCount
* mainContact
* metafield
* metafields
* name
* note
* orders
* ordersCount
* totalSpent
* updatedAt

### Deprecated fields

* contactCount: deprecated
* metafieldDefinitions: deprecated

***

## Map

### Fields and connections with this object

* [CompanyConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/CompanyConnection#returns-nodes)
* [CompanyContact.company](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyContact#field-CompanyContact.fields.company)
* [CompanyContactRoleAssignment.company](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyContactRoleAssignment#field-CompanyContactRoleAssignment.fields.company)
* [CompanyEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyEdge#field-CompanyEdge.fields.node)
* [CompanyLocation.company](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocation#field-CompanyLocation.fields.company)
* [PurchasingCompany.company](https://shopify.dev/docs/api/admin-graphql/latest/objects/PurchasingCompany#field-PurchasingCompany.fields.company)

### Possible type in

* [Metafield​Reference](https://shopify.dev/docs/api/admin-graphql/latest/unions/MetafieldReference)
* [Metafield​Referencer](https://shopify.dev/docs/api/admin-graphql/latest/unions/MetafieldReferencer)

***

## Queries

* companies
* company

***

## Company Queries

### Queried by

* [companies](https://shopify.dev/docs/api/admin-graphql/latest/queries/companies)
* [company](https://shopify.dev/docs/api/admin-graphql/latest/queries/company)

***

## Mutations

* companyAssignMainContact
* companyCreate
* companyRevokeMainContact
* companyUpdate

***

## Company Mutations

### Mutated by

* [company​Assign​Main​Contact](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyAssignMainContact)
* [company​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyCreate)
* [company​Revoke​Main​Contact](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyRevokeMainContact)
* [company​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyUpdate)

***

## Interfaces

* CommentEventSubject
* HasEvents
* HasMetafieldDefinitions
* HasMetafields
* Navigable
* Node

***

## Company Implements

### Implements

* [Comment​Event​Subject](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/CommentEventSubject)
* [Has​Events](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasEvents)
* [Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafieldDefinitions)
* [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafields)
* [Navigable](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Navigable)
* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)