---
title: CartBuyerIdentity - Storefront API
description: >
  Contact information about the buyer interacting with a
  [cart](/docs/api/storefront/unstable/objects/Cart). The buyer's country
  determines [international
  pricing](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/markets/international-pricing)
  and should match their shipping address.


  For B2B scenarios, the
  [`purchasingCompany`](/docs/api/storefront/unstable/objects/CartBuyerIdentity#field-CartBuyerIdentity.fields.purchasingCompany)
  field identifies the company and location on whose behalf a business customer
  purchases. The
  [`preferences`](/docs/api/storefront/unstable/objects/CartBuyerIdentity#field-CartBuyerIdentity.fields.preferences)
  field stores delivery and wallet settings that prefill checkout fields to
  streamline the buying process.
api_version: unstable
api_name: storefront
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/objects/CartBuyerIdentity'
  md: 'https://shopify.dev/docs/api/storefront/latest/objects/CartBuyerIdentity.md'
---

# Cart​Buyer​Identity

object

Contact information about the buyer interacting with a [cart](https://shopify.dev/docs/api/storefront/unstable/objects/Cart). The buyer's country determines [international pricing](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/markets/international-pricing) and should match their shipping address.

For B2B scenarios, the [`purchasingCompany`](https://shopify.dev/docs/api/storefront/unstable/objects/CartBuyerIdentity#field-CartBuyerIdentity.fields.purchasingCompany) field identifies the company and location on whose behalf a business customer purchases. The [`preferences`](https://shopify.dev/docs/api/storefront/unstable/objects/CartBuyerIdentity#field-CartBuyerIdentity.fields.preferences) field stores delivery and wallet settings that prefill checkout fields to streamline the buying process.

## Fields

* country​Code

  [Country​Code](https://shopify.dev/docs/api/storefront/unstable/enums/CountryCode)

  The country where the buyer is located.

* customer

  [Customer](https://shopify.dev/docs/api/storefront/unstable/objects/Customer)

  Token access required

  The customer account associated with the cart.

* email

  [String](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

  The email address of the buyer that's interacting with the cart.

* phone

  [String](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

  The phone number of the buyer that's interacting with the cart.

* preferences

  [Cart​Preferences](https://shopify.dev/docs/api/storefront/unstable/objects/CartPreferences)

  A set of preferences tied to the buyer interacting with the cart. Preferences are used to prefill fields in at checkout to streamline information collection. Preferences are not synced back to the cart if they are overwritten.

* purchasing​Company

  [Purchasing​Company](https://shopify.dev/docs/api/storefront/unstable/objects/PurchasingCompany)

  The purchasing company associated with the cart.

* delivery​Address​Preferences

  [\[Delivery​Address!\]!](https://shopify.dev/docs/api/storefront/unstable/unions/DeliveryAddress)

  non-nullDeprecated

***

## Map

### Fields with this object

* [Cart.buyerIdentity](https://shopify.dev/docs/api/storefront/unstable/objects/Cart#field-Cart.fields.buyerIdentity)