> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

---
title: "BuyerIdentity"
description: "Represents the buyer's information within the API schema. It enables the system to accurately process orders, calculate shipping costs, handle taxes, and communicate with the buyer as needed throughout the purchasing process. This object ensures a smooth and efficient experience for both the buyer and the seller."
---

## Fields

***

<ParamField path="firstName" type="String">
  First name of the person or company.
</ParamField>

<ParamField path="lastName" type="String">
  Last name of the person or company.
</ParamField>

<ParamField path="email" type="String">
  A string representing the email address of the person or the company.
</ParamField>

<ParamField path="phone" type="String">
  A 10-digit phone number, in [E.164](https://www.twilio.com/docs/glossary/what-e164) format.
</ParamField>

<ParamField path="address1" type="String">
  The first line of the address, such as the street name and number.
</ParamField>

<ParamField path="address2" type="String">
  The second line of the address, typically used for additional information such as an apartment or suite number.
</ParamField>

<ParamField path="city" type="String">
  A string representing the name of the city, district, village, or town where the buyer is located.
</ParamField>

<ParamField path="provinceCode" type="String">
  The ISO 3166-2 english province code without the country code or a full province name.

  Example: `CA` for California, `DE` for Delaware. "Auckland" as a province name is also valid.
</ParamField>

<ParamField path="countryCode" type={<a href="/api-reference/country">Country!</a>} required>
  Two letter ISO 3166-1 alpha-2 country code. Territories not explicitly defined in the [`Country`](/api-reference/country) enum are treated as subdivisions of their respective parent countries.

  Example: `US` for United States, or `NZ` for New Zealand.
</ParamField>

<ParamField path="postalCode" type="String">
  A string representing the area postal code or ZIP code.
</ParamField>

### Mutations

[`updateCartBuyerIdentity(input: CartBuyerIdentityUpdateInput!)`](/api-reference/updatecartbuyeridentity)

Updates buyer identity if not provided in [`createCart`](/api-reference/createcart) mutation

### Related types

* [`BuyerIdentityInput`](/api-reference/buyeridentityinput)


---

*Powered by [holocron.so](https://holocron.so)*