This query retrieves a comprehensive set of fields for the first 50 [customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/customer) records using an extended [`nodes`](https://shopify.dev/docs/api/admin-graphql/latest/queries/customers#field-nodes) selection.
The query demonstrates how to retrieve various details in a single request.
Response
{
"customers": {
"nodes": [
{
"id": "gid://shopify/Customer/56501169",
"firstName": "Jenny",
"lastName": "Test",
"defaultEmailAddress": {
"emailAddress": "jennytest@b2b.example.com",
"marketingState": "NOT_SUBSCRIBED"
},
"defaultPhoneNumber": {
"phoneNumber": "+13125551219",
"marketingState": "NOT_SUBSCRIBED",
"marketingCollectedFrom": null
},
"createdAt": "2025-04-15T19:26:33Z",
"updatedAt": "2025-04-15T19:26:33Z",
"numberOfOrders": "0",
"state": "DISABLED",
"amountSpent": {
"amount": "0.0",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [],
"addresses": [],
"defaultAddress": null
},
{
"id": "gid://shopify/Customer/105906728",
"firstName": "John",
"lastName": "Smith",
"defaultEmailAddress": {
"emailAddress": "johnsmith@example.com",
"marketingState": "NOT_SUBSCRIBED"
},
"defaultPhoneNumber": {
"phoneNumber": "+16134504532",
"marketingState": "NOT_SUBSCRIBED",
"marketingCollectedFrom": "OTHER"
},
"createdAt": "2025-04-15T19:26:33Z",
"updatedAt": "2025-04-15T19:26:33Z",
"numberOfOrders": "0",
"state": "DISABLED",
"amountSpent": {
"amount": "0.0",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [],
"addresses": [
{
"id": "gid://shopify/MailingAddress/105906728?model_name=CustomerAddress",
"firstName": "John",
"lastName": "Smith",
"address1": "124 Big Green St",
"city": "Ottawa",
"province": "Ontario",
"country": "Canada",
"zip": "K2H7A8",
"phone": "+1(613)555-1212",
"name": "John Smith",
"provinceCode": "ON",
"countryCodeV2": "CA"
}
],
"defaultAddress": {
"id": "gid://shopify/MailingAddress/105906728?model_name=CustomerAddress",
"address1": "124 Big Green St",
"city": "Ottawa",
"province": "Ontario",
"country": "Canada",
"zip": "K2H7A8",
"phone": "+1(613)555-1212",
"provinceCode": "ON",
"countryCodeV2": "CA"
}
},
{
"id": "gid://shopify/Customer/305367469",
"firstName": "Test",
"lastName": "Customer",
"defaultEmailAddress": null,
"defaultPhoneNumber": null,
"createdAt": "2025-04-15T19:26:33Z",
"updatedAt": "2025-04-15T19:26:33Z",
"numberOfOrders": "0",
"state": "DISABLED",
"amountSpent": {
"amount": "0.0",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [],
"addresses": [],
"defaultAddress": null
},
{
"id": "gid://shopify/Customer/317070273",
"firstName": "Bob",
"lastName": "Norman",
"defaultEmailAddress": null,
"defaultPhoneNumber": {
"phoneNumber": "+16134504538",
"marketingState": "SUBSCRIBED",
"marketingCollectedFrom": "OTHER"
},
"createdAt": "2025-04-15T19:26:33Z",
"updatedAt": "2025-04-15T19:26:33Z",
"numberOfOrders": "0",
"state": "DISABLED",
"amountSpent": {
"amount": "0.0",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [],
"addresses": [
{
"id": "gid://shopify/MailingAddress/317070273?model_name=CustomerAddress",
"firstName": null,
"lastName": null,
"address1": "Chestnut Street 92",
"city": "Louisville",
"province": "KY",
"country": "US",
"zip": "40202",
"phone": "555-625-1199",
"name": "",
"provinceCode": "KY",
"countryCodeV2": "US"
}
],
"defaultAddress": {
"id": "gid://shopify/MailingAddress/317070273?model_name=CustomerAddress",
"address1": "Chestnut Street 92",
"city": "Louisville",
"province": "KY",
"country": "US",
"zip": "40202",
"phone": "555-625-1199",
"provinceCode": "KY",
"countryCodeV2": "US"
}
},
{
"id": "gid://shopify/Customer/324586928",
"firstName": "B2B",
"lastName": "Customer",
"defaultEmailAddress": {
"emailAddress": "b2b@example.com",
"marketingState": "NOT_SUBSCRIBED"
},
"defaultPhoneNumber": {
"phoneNumber": "+13125551213",
"marketingState": "NOT_SUBSCRIBED",
"marketingCollectedFrom": null
},
"createdAt": "2025-04-15T19:26:33Z",
"updatedAt": "2025-04-15T19:26:33Z",
"numberOfOrders": "1",
"state": "ENABLED",
"amountSpent": {
"amount": "32.4",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [],
"addresses": [],
"defaultAddress": null
},
{
"id": "gid://shopify/Customer/352184960",
"firstName": "Jenny",
"lastName": "Doe",
"defaultEmailAddress": {
"emailAddress": "jennydoe@b2bmigration.com",
"marketingState": "NOT_SUBSCRIBED"
},
"defaultPhoneNumber": null,
"createdAt": "2025-04-15T19:26:33Z",
"updatedAt": "2025-04-15T19:26:33Z",
"numberOfOrders": "0",
"state": "DISABLED",
"amountSpent": {
"amount": "0.0",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [],
"addresses": [],
"defaultAddress": null
},
{
"id": "gid://shopify/Customer/408913340",
"firstName": "John",
"lastName": "Doe",
"defaultEmailAddress": {
"emailAddress": "john@doe.com",
"marketingState": "SUBSCRIBED"
},
"defaultPhoneNumber": {
"phoneNumber": "+16134504534",
"marketingState": "SUBSCRIBED",
"marketingCollectedFrom": null
},
"createdAt": "2025-04-15T19:26:33Z",
"updatedAt": "2025-04-15T19:26:33Z",
"numberOfOrders": "0",
"state": "DISABLED",
"amountSpent": {
"amount": "0.0",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [],
"addresses": [
{
"id": "gid://shopify/MailingAddress/408913340?model_name=CustomerAddress",
"firstName": "John",
"lastName": "Doe",
"address1": "123 Amoebobacterieae St",
"city": "Ottawa",
"province": "Ontario",
"country": "Canada",
"zip": "K2P0V6",
"phone": "+16134504534",
"name": "John Doe",
"provinceCode": "ON",
"countryCodeV2": "CA"
}
],
"defaultAddress": {
"id": "gid://shopify/MailingAddress/408913340?model_name=CustomerAddress",
"address1": "123 Amoebobacterieae St",
"city": "Ottawa",
"province": "Ontario",
"country": "Canada",
"zip": "K2P0V6",
"phone": "+16134504534",
"provinceCode": "ON",
"countryCodeV2": "CA"
}
},
{
"id": "gid://shopify/Customer/529223679",
"firstName": "Bob",
"lastName": "Marketing",
"defaultEmailAddress": {
"emailAddress": "email_marketing_pending_customer@example.com",
"marketingState": "PENDING"
},
"defaultPhoneNumber": null,
"createdAt": "2025-04-15T19:26:33Z",
"updatedAt": "2025-04-15T19:26:33Z",
"numberOfOrders": "0",
"state": "DISABLED",
"amountSpent": {
"amount": "0.0",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [],
"addresses": [],
"defaultAddress": null
},
{
"id": "gid://shopify/Customer/544365967",
"firstName": "Bob",
"lastName": "Bobsen",
"defaultEmailAddress": {
"emailAddress": "bob@example.com",
"marketingState": "SUBSCRIBED"
},
"defaultPhoneNumber": {
"phoneNumber": "+13125551212",
"marketingState": "NOT_SUBSCRIBED",
"marketingCollectedFrom": "OTHER"
},
"createdAt": "2005-06-15T15:57:11Z",
"updatedAt": "2005-06-16T15:57:11Z",
"numberOfOrders": "25",
"state": "ENABLED",
"amountSpent": {
"amount": "8305.6",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [
"Bob",
"Canadian",
"Léon",
"Noël"
],
"addresses": [
{
"id": "gid://shopify/MailingAddress/544365967?model_name=CustomerAddress",
"firstName": "Bob",
"lastName": "Bobsen",
"address1": "123 Amoebobacterieae St",
"city": "Ottawa",
"province": "Ontario",
"country": "Canada",
"zip": "K2P0V6",
"phone": "+1(613)555-1212",
"name": "Bob Bobsen",
"provinceCode": "ON",
"countryCodeV2": "CA"
}
],
"defaultAddress": {
"id": "gid://shopify/MailingAddress/544365967?model_name=CustomerAddress",
"address1": "123 Amoebobacterieae St",
"city": "Ottawa",
"province": "Ontario",
"country": "Canada",
"zip": "K2P0V6",
"phone": "+1(613)555-1212",
"provinceCode": "ON",
"countryCodeV2": "CA"
}
},
{
"id": "gid://shopify/Customer/554122808",
"firstName": "Bob",
"lastName": "Bobsen",
"defaultEmailAddress": {
"emailAddress": "test_remove@example.com",
"marketingState": "NOT_SUBSCRIBED"
},
"defaultPhoneNumber": {
"phoneNumber": "+13125551212",
"marketingState": "NOT_SUBSCRIBED",
"marketingCollectedFrom": "OTHER"
},
"createdAt": "2005-06-15T15:57:11Z",
"updatedAt": "2005-06-16T15:57:11Z",
"numberOfOrders": "0",
"state": "ENABLED",
"amountSpent": {
"amount": "0.0",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [],
"addresses": [],
"defaultAddress": {
"id": "gid://shopify/MailingAddress/544365967?model_name=CustomerAddress",
"address1": "123 Amoebobacterieae St",
"city": "Ottawa",
"province": "Ontario",
"country": "Canada",
"zip": "K2P0V6",
"phone": "+1(613)555-1212",
"provinceCode": "ON",
"countryCodeV2": "CA"
}
},
{
"id": "gid://shopify/Customer/554456816",
"firstName": "test",
"lastName": "test",
"defaultEmailAddress": null,
"defaultPhoneNumber": null,
"createdAt": "2025-04-15T19:26:33Z",
"updatedAt": "2025-04-15T19:26:33Z",
"numberOfOrders": "0",
"state": "DISABLED",
"amountSpent": {
"amount": "0.0",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [],
"addresses": [
{
"id": "gid://shopify/MailingAddress/568874073?model_name=CustomerAddress",
"firstName": "test",
"lastName": "test",
"address1": "1005 Jervis St",
"city": "Ottawa",
"province": "Ontario",
"country": "Canada",
"zip": "V2E 3T1",
"phone": "+1(613)555-1212",
"name": "test test",
"provinceCode": "ON",
"countryCodeV2": "CA"
},
{
"id": "gid://shopify/MailingAddress/768736626?model_name=CustomerAddress",
"firstName": "test",
"lastName": "test",
"address1": "620 King Street West",
"city": "Toronto",
"province": "Ontario",
"country": "Canada",
"zip": "M5V 1M6",
"phone": "+1(613)555-1212",
"name": "test test",
"provinceCode": "ON",
"countryCodeV2": "CA"
}
],
"defaultAddress": {
"id": "gid://shopify/MailingAddress/568874073?model_name=CustomerAddress",
"address1": "1005 Jervis St",
"city": "Ottawa",
"province": "Ontario",
"country": "Canada",
"zip": "V2E 3T1",
"phone": "+1(613)555-1212",
"provinceCode": "ON",
"countryCodeV2": "CA"
}
},
{
"id": "gid://shopify/Customer/567375318",
"firstName": "Jane",
"lastName": "Smith",
"defaultEmailAddress": {
"emailAddress": "janesmith@b2b.example.com",
"marketingState": "NOT_SUBSCRIBED"
},
"defaultPhoneNumber": {
"phoneNumber": "+13125551217",
"marketingState": "NOT_SUBSCRIBED",
"marketingCollectedFrom": null
},
"createdAt": "2025-04-15T19:26:33Z",
"updatedAt": "2025-04-15T19:26:33Z",
"numberOfOrders": "0",
"state": "DISABLED",
"amountSpent": {
"amount": "0.0",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [],
"addresses": [],
"defaultAddress": null
},
{
"id": "gid://shopify/Customer/624407574",
"firstName": "Bob",
"lastName": "Bobsen Jr.",
"defaultEmailAddress": {
"emailAddress": "tobi.leetsoft@example.com",
"marketingState": "NOT_SUBSCRIBED"
},
"defaultPhoneNumber": null,
"createdAt": "2005-06-15T15:57:11Z",
"updatedAt": "2005-06-16T15:57:11Z",
"numberOfOrders": "2",
"state": "ENABLED",
"amountSpent": {
"amount": "32.0",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [],
"addresses": [
{
"id": "gid://shopify/MailingAddress/624407574?model_name=CustomerAddress",
"firstName": null,
"lastName": null,
"address1": "124 Amoebobacterieae St",
"city": "Ottawa",
"province": "Ontario",
"country": "Canada",
"zip": "K2P0V7",
"phone": "+1(613)555-1212",
"name": "",
"provinceCode": "ON",
"countryCodeV2": "CA"
}
],
"defaultAddress": {
"id": "gid://shopify/MailingAddress/624407574?model_name=CustomerAddress",
"address1": "124 Amoebobacterieae St",
"city": "Ottawa",
"province": "Ontario",
"country": "Canada",
"zip": "K2P0V7",
"phone": "+1(613)555-1212",
"provinceCode": "ON",
"countryCodeV2": "CA"
}
},
{
"id": "gid://shopify/Customer/649400230",
"firstName": "Bob",
"lastName": "Bobsen",
"defaultEmailAddress": {
"emailAddress": "bob_exempt@example.com",
"marketingState": "NOT_SUBSCRIBED"
},
"defaultPhoneNumber": {
"phoneNumber": "+13125551226",
"marketingState": "NOT_SUBSCRIBED",
"marketingCollectedFrom": null
},
"createdAt": "2005-06-15T15:57:11Z",
"updatedAt": "2005-06-16T15:57:11Z",
"numberOfOrders": "0",
"state": "ENABLED",
"amountSpent": {
"amount": "0.0",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": true,
"tags": [],
"addresses": [],
"defaultAddress": {
"id": "gid://shopify/MailingAddress/544365967?model_name=CustomerAddress",
"address1": "123 Amoebobacterieae St",
"city": "Ottawa",
"province": "Ontario",
"country": "Canada",
"zip": "K2P0V6",
"phone": "+1(613)555-1212",
"provinceCode": "ON",
"countryCodeV2": "CA"
}
},
{
"id": "gid://shopify/Customer/649509010",
"firstName": "Bob",
"lastName": "Bobsen",
"defaultEmailAddress": {
"emailAddress": "email@example.com",
"marketingState": "SUBSCRIBED"
},
"defaultPhoneNumber": {
"phoneNumber": "+13125551215",
"marketingState": "NOT_SUBSCRIBED",
"marketingCollectedFrom": null
},
"createdAt": "2025-04-15T19:26:33Z",
"updatedAt": "2025-04-15T19:26:33Z",
"numberOfOrders": "0",
"state": "ENABLED",
"amountSpent": {
"amount": "0.0",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [],
"addresses": [
{
"id": "gid://shopify/MailingAddress/649509010?model_name=CustomerAddress",
"firstName": "Bob",
"lastName": "Bobsen",
"address1": "",
"city": "Ottawa",
"province": "",
"country": "",
"zip": "",
"phone": "+1(613)555-1212",
"name": "Bob Bobsen",
"provinceCode": null,
"countryCodeV2": null
}
],
"defaultAddress": {
"id": "gid://shopify/MailingAddress/649509010?model_name=CustomerAddress",
"address1": "",
"city": "Ottawa",
"province": "",
"country": "",
"zip": "",
"phone": "+1(613)555-1212",
"provinceCode": null,
"countryCodeV2": null
}
},
{
"id": "gid://shopify/Customer/657584747",
"firstName": "Jane",
"lastName": "Deletable",
"defaultEmailAddress": {
"emailAddress": "jane_deletable@b2b.example.com",
"marketingState": "NOT_SUBSCRIBED"
},
"defaultPhoneNumber": {
"phoneNumber": "+13125551218",
"marketingState": "NOT_SUBSCRIBED",
"marketingCollectedFrom": null
},
"createdAt": "2025-04-15T19:26:33Z",
"updatedAt": "2025-04-15T19:26:33Z",
"numberOfOrders": "0",
"state": "DISABLED",
"amountSpent": {
"amount": "0.0",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [],
"addresses": [],
"defaultAddress": null
},
{
"id": "gid://shopify/Customer/681865419",
"firstName": "Signup",
"lastName": "Bot",
"defaultEmailAddress": {
"emailAddress": "bot@suppression.com",
"marketingState": "SUBSCRIBED"
},
"defaultPhoneNumber": null,
"createdAt": "2025-04-15T19:26:33Z",
"updatedAt": "2025-04-15T19:26:33Z",
"numberOfOrders": "0",
"state": "DISABLED",
"amountSpent": {
"amount": "0.0",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [],
"addresses": [],
"defaultAddress": null
},
{
"id": "gid://shopify/Customer/839649557",
"firstName": "Bob",
"lastName": "Bobsen",
"defaultEmailAddress": {
"emailAddress": "test_example@example.com",
"marketingState": "NOT_SUBSCRIBED"
},
"defaultPhoneNumber": {
"phoneNumber": "+16136120709",
"marketingState": "NOT_SUBSCRIBED",
"marketingCollectedFrom": null
},
"createdAt": "2005-06-15T15:57:11Z",
"updatedAt": "2005-06-16T15:57:11Z",
"numberOfOrders": "0",
"state": "ENABLED",
"amountSpent": {
"amount": "0.0",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [],
"addresses": [],
"defaultAddress": {
"id": "gid://shopify/MailingAddress/544365967?model_name=CustomerAddress",
"address1": "123 Amoebobacterieae St",
"city": "Ottawa",
"province": "Ontario",
"country": "Canada",
"zip": "K2P0V6",
"phone": "+1(613)555-1212",
"provinceCode": "ON",
"countryCodeV2": "CA"
}
},
{
"id": "gid://shopify/Customer/880980251",
"firstName": "Danny",
"lastName": "Doe",
"defaultEmailAddress": {
"emailAddress": "dannydoe@b2bmigration.com",
"marketingState": "NOT_SUBSCRIBED"
},
"defaultPhoneNumber": {
"phoneNumber": "+14155483921",
"marketingState": "NOT_SUBSCRIBED",
"marketingCollectedFrom": null
},
"createdAt": "2025-04-15T19:26:33Z",
"updatedAt": "2025-04-15T19:26:33Z",
"numberOfOrders": "0",
"state": "DISABLED",
"amountSpent": {
"amount": "0.0",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [],
"addresses": [
{
"id": "gid://shopify/MailingAddress/420236291?model_name=CustomerAddress",
"firstName": "Danny",
"lastName": "Doe",
"address1": "1005 Jervis St",
"city": "Ottawa",
"province": "British Columbia",
"country": "Canada",
"zip": "V2E3T1",
"phone": "16135551212",
"name": "Danny Doe",
"provinceCode": "BC",
"countryCodeV2": "CA"
}
],
"defaultAddress": {
"id": "gid://shopify/MailingAddress/420236291?model_name=CustomerAddress",
"address1": "1005 Jervis St",
"city": "Ottawa",
"province": "British Columbia",
"country": "Canada",
"zip": "V2E3T1",
"phone": "16135551212",
"provinceCode": "BC",
"countryCodeV2": "CA"
}
},
{
"id": "gid://shopify/Customer/912646312",
"firstName": "Bob",
"lastName": "Bulk",
"defaultEmailAddress": {
"emailAddress": "bobbulk@example.com",
"marketingState": "NOT_SUBSCRIBED"
},
"defaultPhoneNumber": null,
"createdAt": "2025-04-15T19:26:33Z",
"updatedAt": "2025-04-15T19:26:33Z",
"numberOfOrders": "0",
"state": "INVITED",
"amountSpent": {
"amount": "0.0",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [],
"addresses": [],
"defaultAddress": null
},
{
"id": "gid://shopify/Customer/953307753",
"firstName": "Adam",
"lastName": "Felix",
"defaultEmailAddress": {
"emailAddress": "b2b@example.com",
"marketingState": "NOT_SUBSCRIBED"
},
"defaultPhoneNumber": {
"phoneNumber": "+13125551213",
"marketingState": "NOT_SUBSCRIBED",
"marketingCollectedFrom": null
},
"createdAt": "2025-04-15T19:26:33Z",
"updatedAt": "2025-04-15T19:26:33Z",
"numberOfOrders": "0",
"state": "DISABLED",
"amountSpent": {
"amount": "0.0",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [],
"addresses": [],
"defaultAddress": null
},
{
"id": "gid://shopify/Customer/1018520244",
"firstName": "Bob",
"lastName": "Bobsen",
"defaultEmailAddress": {
"emailAddress": "bob@example.org",
"marketingState": "NOT_SUBSCRIBED"
},
"defaultPhoneNumber": {
"phoneNumber": "+13125551216",
"marketingState": "NOT_SUBSCRIBED",
"marketingCollectedFrom": "OTHER"
},
"createdAt": "2025-04-15T19:26:33Z",
"updatedAt": "2025-04-15T19:26:33Z",
"numberOfOrders": "12",
"state": "ENABLED",
"amountSpent": {
"amount": "100122.5",
"currencyCode": "USD"
},
"verifiedEmail": true,
"taxExempt": false,
"tags": [
"A+ Marketing",
"Canadian"
],
"addresses": [
{
"id": "gid://shopify/MailingAddress/1018520244?model_name=CustomerAddress",
"firstName": null,
"lastName": null,
"address1": "123 Amoebobacterieae St",
"city": "Ottawa",
"province": "Ontario",
"country": "Canada",
"zip": "K2P0V6",
"phone": "+1(613)555-1212",
"name": "",
"provinceCode": "ON",
"countryCodeV2": "CA"
}
],
"defaultAddress": {
"id": "gid://shopify/MailingAddress/1018520244?model_name=CustomerAddress",
"address1": "123 Amoebobacterieae St",
"city": "Ottawa",
"province": "Ontario",
"country": "Canada",
"zip": "K2P0V6",
"phone": "+1(613)555-1212",
"provinceCode": "ON",
"countryCodeV2": "CA"
}
}
]
}
}