DtoCustomer

number

A unique identifier for the customer.

Example:

6087092306145

string

The unique email address of the customer. Attempting to assign the same email address to multiple customers returns an error.

Example:

test@shopping.com

accepts_marketing

boolean

As of API version 2022-04, this field is deprecated. Use email_marketing_consent instead. Whether the customer has consented to receive marketing material by email.

Example:

false

created_at

string

The date and time (ISO 8601 format) when the customer was created.

Example:

2022-02-21T09:31:56-05:00

updated_at

string

The date and time (ISO 8601 format) when the customer information was last updated

Example:

2022-03-11T18:48:57-05:00

first_name

string

The customer's first name.

Example:

pruebas envio

last_name

string

The customer's last name.

Example:

Chile

orders_count

number

The number of orders associated with this customer. Test and archived orders aren't counted.

Example:

state

string

'The state of the customer's account with a shop. Default value: disabled. Valid values:'

Example:

disabled

total_spent

number

The total amount of money that the customer has spent across their order history.

Example:

375.3

last_order_id

number

The ID of the customer's last order.

Example:

234132602919

note

string

A note about the customer.

Example:

Placed an order that had a fraud warning

verified_email

boolean

Whether the customer has verified their email address.

Example:

true

multipass_identifier

number

A unique identifier for the customer that's used with ' 'Multipass login.

Example:

null

tax_exempt

boolean

Whether the customer is exempt from paying taxes on their order. If true, then taxes won't be applied to an order at checkout. If false, then taxes will be applied at checkout.

Example:

false

phone

string

The unique phone number (E.164 format) for this customer. Attempting to assign the same phone number to multiple customers returns an error. The property can be set using different formats, but each format must represent a number that can be dialed from anywhere in the world.

Example:

555-625-1199

tags

string

Tags that the shop owner has attached to the customer, formatted as a string of comma-separated values. A customer can have up to 250 tags. Each tag can have up to 255 characters.

Example:

last_order_name

string

The name of the customer's last order. This is directly related to the name field on the Order resource.

Example:

#1169

currency

string

he three-letter code (ISO 4217 format) for the currency that the customer used when they paid for their last order. Defaults to the shop currency. Returns the shop currency for test orders.

Example:

CLP

accepts_marketing_updated_at

string

As of API version 2022-04, this field is deprecated. Use email_marketing_consent instead. The date and time (ISO 8601 format) when the customer consented or objected to receiving marketing material by email. Set this value whenever the customer consents or objects to marketing materials.

Example:

2022-02-21T09:31:56-05:00

tax_exemptions

array[string]

'Whether the customer is exempt from paying specific taxes on their order. Canadian taxes only. Valid values:'

Example:

["CA_STATUS_CARD_EXEMPTION","CA_BC_RESELLER_EXEMPTION"]

admin_graphql_api_id

string

A unique identifier for the customer for Api GraphQl.

Example:

gid://shopify/Customer/6087092306145

default_address

object

'The mailing address associated with the payment method. This address is an optional field that won't be available on orders that do not require a payment method. It has the following properties:'

number

A unique identifier for the address.

Example:

7620158161121

customer_id

number

A unique identifier for the customer.

Example:

6087092306145

first_name

string

The first name of the person associated with the payment method.

Example:

pruebas envio

last_name

string

The last name of the person associated with the payment method.

Example:

Chile

company

string

The company of the person associated with the billing address.

Example:

null

address1

string

The street address of the billing address.

Example:

San Francisco 2511

address2

string

An optional additional field for the street address of the billing address.

Example:

Apartment 5

city

string

The city, town, or village of the billing address.

Example:

San Miguel

province

string

The name of the region (for example, province, state, or prefecture) of the billing address.

Example:

Santiago

country

string

The name of the country of the billing address.

Example:

Chile

zip

string

The postal code (for example, zip, postcode, or Eircode) of the billing address.

Example:

8320000

phone

string

The phone number at the billing address.

Example:

+(53)999888777

name

string

The full name of the person associated with the payment method.

Example:

pruebas envio Chile

latitude

number

The latitude of the billing address.

Example:

-33.4777172

longitude

number

The longitude of the billing address.

Example:

-70.6436693

country_code

string

The two-letter code (ISO 3166-1 format) for the country of the billing address.

Example:

province_code

string

The two-letter abbreviation of the region of the billing address.

Example:

country_name

string

The customer's normalized country name.

Example:

Chile

default

boolean

Returns true for each default address.

Example:

true

Example

1
{
2
  "id": 6087092306145,
3
  "email": "test@shopping.com",
4
  "accepts_marketing": false,
5
  "created_at": "2022-02-21T09:31:56-05:00",
6
  "updated_at": "2022-03-11T18:48:57-05:00",
7
  "first_name": "pruebas envio",
8
  "last_name": "Chile",
9
  "orders_count": 5,
10
  "state": "disabled",
11
  "total_spent": 375.3,
12
  "last_order_id": 234132602919,
13
  "note": "Placed an order that had a fraud warning",
14
  "verified_email": true,
15
  "multipass_identifier": null,
16
  "tax_exempt": false,
17
  "phone": "555-625-1199",
18
  "tags": "",
19
  "last_order_name": "#1169",
20
  "currency": "CLP",
21
  "accepts_marketing_updated_at": "2022-02-21T09:31:56-05:00",
22
  "tax_exemptions": [
23
    "CA_STATUS_CARD_EXEMPTION",
24
    "CA_BC_RESELLER_EXEMPTION"
25
  ],
26
  "admin_graphql_api_id": "gid://shopify/Customer/6087092306145",
27
  "default_address": {
28
    "id": 7620158161121,
29
    "customer_id": 6087092306145,
30
    "first_name": "pruebas envio",
31
    "last_name": "Chile",
32
    "company": null,
33
    "address1": "San Francisco 2511",
34
    "address2": "Apartment 5",
35
    "city": "San Miguel",
36
    "province": "Santiago",
37
    "country": "Chile",
38
    "zip": "8320000",
39
    "phone": "+(53)999888777",
40
    "name": "pruebas envio Chile",
41
    "latitude": -33.4777172,
42
    "longitude": -70.6436693,
43
    "country_code": "CL",
44
    "province_code": "RM",
45
    "country_name": "Chile",
46
    "default": true
47
  }
48
}

Shopify API

DtoCustomer