Resource
Customers
The customer object
Attributes
idintegerExample:32shopify_customer_idstringExample:gid://shopify/Customer/9001namestringExample:Zoe Quinnfirst_namestringExample:Zoelast_namestringExample:QuinnemailstringExample:zoe@example.comphonestring, nullabletax_numberstringExample:DE123eori_numberstring, nullabletagsarray of stringsedited_in_appbooleanExample:falsedefault_addressobjectShow 16 child attributesHide child attributes
idintegerExample:587kindstringExample:default_addressnamestring, nullablefirst_namestring, nullablelast_namestring, nullablecompanystringExample:Quinn GmbHaddress1stringExample:1 Main Staddress2string, nullablecitystringExample:Berlinprovincestring, nullablezipstringExample:10115countrystringExample:Germanycountry_codestringExample:DEphonestring, nullabletax_numberstring, nullableeori_numberstring, nullable
created_atstringExample:2026-11-10T08:50:31Zupdated_atstringExample:2026-11-10T08:50:31Znotestring, nullableaddressesarray of objectsShow 16 child attributesHide child attributes
idintegerExample:587kindstringExample:default_addressnamestring, nullablefirst_namestring, nullablelast_namestring, nullablecompanystringExample:Quinn GmbHaddress1stringExample:1 Main Staddress2string, nullablecitystringExample:Berlinprovincestring, nullablezipstringExample:10115countrystringExample:Germanycountry_codestringExample:DEphonestring, nullabletax_numberstring, nullableeori_numberstring, nullable
documentsobjectShow 2 child attributesHide child attributes
countintegerExample:1recentarray of objectsShow 7 child attributesHide child attributes
idintegerExample:980191020typestringExample:invoicenumberstringExample:INV-9shopify_order_idstringExample:gid://shopify/Order/1created_atstringExample:2026-11-10T08:50:31Zsent_atstringExample:2026-01-02T00:00:00Zpaid_atstring, nullable
Endpoints
The customer object
{
"id": 32,
"shopify_customer_id": "gid://shopify/Customer/9001",
"name": "Zoe Quinn",
"first_name": "Zoe",
"last_name": "Quinn",
"email": "zoe@example.com",
"phone": null,
"tax_number": "DE123",
"eori_number": null,
"tags": [
"vip",
"wholesale"
],
"edited_in_app": false,
"default_address": {
"id": 587,
"kind": "default_address",
"name": null,
"first_name": null,
"last_name": null,
"company": "Quinn GmbH",
"address1": "1 Main St",
"address2": null,
"city": "Berlin",
"province": null,
"zip": "10115",
"country": "Germany",
"country_code": "DE",
"phone": null,
"tax_number": null,
"eori_number": null
},
"created_at": "2026-11-10T08:50:31Z",
"updated_at": "2026-11-10T08:50:31Z",
"note": null,
"addresses": [
{
"id": 587,
"kind": "default_address",
"name": null,
"first_name": null,
"last_name": null,
"company": "Quinn GmbH",
"address1": "1 Main St",
"address2": null,
"city": "Berlin",
"province": null,
"zip": "10115",
"country": "Germany",
"country_code": "DE",
"phone": null,
"tax_number": null,
"eori_number": null
}
],
"documents": {
"count": 1,
"recent": [
{
"id": 980191020,
"type": "invoice",
"number": "INV-9",
"shopify_order_id": "gid://shopify/Order/1",
"created_at": "2026-11-10T08:50:31Z",
"sent_at": "2026-01-02T00:00:00Z",
"paid_at": null
}
]
}
}