---
title: PurchasingEntity - Customer API
description: Represents information about the purchasing entity for the order or draft order.
api_version: 2025-10
api_name: customer
type: union
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/customer/latest/unions/purchasingentity
  md: https://shopify.dev/docs/api/customer/latest/unions/purchasingentity.md
---

# Purchasing​Entity

union

Represents information about the purchasing entity for the order or draft order.

## Possible types

* [Customer](https://shopify.dev/docs/api/customer/latest/objects/Customer)

  OBJECT

  Represents the personal information of a customer. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data).

  * addresses

    [Customer​Address​Connection!](https://shopify.dev/docs/api/customer/latest/connections/CustomerAddressConnection)

    non-null

    The addresses associated with the customer.

  * company​Contacts

    [Company​Contact​Connection!](https://shopify.dev/docs/api/customer/latest/connections/CompanyContactConnection)

    non-null

    The list of contacts the customer is associated with.

  * creation​Date

    [Date​Time!](https://shopify.dev/docs/api/customer/latest/scalars/DateTime)

    non-null

    The date and time when the customer was created.

  * default​Address

    [Customer​Address](https://shopify.dev/docs/api/customer/latest/objects/CustomerAddress)

    The default address of the customer.

  * display​Name

    [String!](https://shopify.dev/docs/api/customer/latest/scalars/String)

    non-null

    The full name of the customer, based on the first\_name and last\_name values. If these aren't available, it falls back to the customer's email address, and if that isn't available, the customer's phone number.

  * draft​Orders

    [Draft​Order​Connection!](https://shopify.dev/docs/api/customer/latest/connections/DraftOrderConnection)

    non-null

    The Draft Orders associated with the customer.

  * email​Address

    [Customer​Email​Address](https://shopify.dev/docs/api/customer/latest/objects/CustomerEmailAddress)

    [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

    The email address of the customer.

  * first​Name

    [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

    The first name of the customer.

  * id

    [ID!](https://shopify.dev/docs/api/customer/latest/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.

  * image​Url

    [URL!](https://shopify.dev/docs/api/customer/latest/scalars/URL)

    non-null

    The URL to the avatar image of the customer.

  * last​Incomplete​Checkout

    [Checkout](https://shopify.dev/docs/api/customer/latest/objects/Checkout)

    The customer's most recently updated, incomplete checkout.

  * last​Name

    [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

    The last name of the customer.

  * metafield

    [Metafield](https://shopify.dev/docs/api/customer/latest/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.

  * metafields

    [\[Metafield\]!](https://shopify.dev/docs/api/customer/latest/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.

  * orders

    [Order​Connection!](https://shopify.dev/docs/api/customer/latest/connections/OrderConnection)

    non-null

    The orders associated with the customer.

  * phone​Number

    [Customer​Phone​Number](https://shopify.dev/docs/api/customer/latest/objects/CustomerPhoneNumber)

    [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

    The phone number of the customer.

  * store​Credit​Accounts

    [Store​Credit​Account​Connection!](https://shopify.dev/docs/api/customer/latest/connections/StoreCreditAccountConnection)

    non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

    A list of the owner resource's store credit accounts. Store credit accounts are not shown for shops with store credit disabled at checkout.

  * subscription​Contract

    [Subscription​Contract](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionContract)

    Returns a `SubscriptionContract` resource by ID.

  * subscription​Contracts

    [Subscription​Contract​Connection!](https://shopify.dev/docs/api/customer/latest/connections/SubscriptionContractConnection)

    non-null

    The Subscription Contracts associated with the customer.

  * tags

    [\[String!\]!](https://shopify.dev/docs/api/customer/latest/scalars/String)

    non-null

    A comma-separated list of tags that have been added to the customer.

* [Purchasing​Company](https://shopify.dev/docs/api/customer/latest/objects/PurchasingCompany)

  OBJECT

  The information of the purchasing company for an order or draft order.

  * company

    [Company!](https://shopify.dev/docs/api/customer/latest/objects/Company)

    non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

    The company associated with the order or draft order.

  * contact

    [Company​Contact](https://shopify.dev/docs/api/customer/latest/objects/CompanyContact)

    [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

    The company contact associated with the order or draft order.

  * location

    [Company​Location!](https://shopify.dev/docs/api/customer/latest/objects/CompanyLocation)

    non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

    The company location associated with the order or draft order.

***

## Fields with this union

* [Draft​Order.​purchasing​Entity](https://shopify.dev/docs/api/customer/latest/objects/DraftOrder#field-purchasingEntity)

  OBJECT

  A draft order for the customer. Any fields related to money are in the presentment currency. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data).

* [Order.​purchasing​Entity](https://shopify.dev/docs/api/customer/latest/objects/Order#field-purchasingEntity)

  OBJECT

  A customer’s completed request to purchase one or more products from a shop. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data).

***

```graphql
union PurchasingEntity = Customer | PurchasingCompany
```