---
title: "customer"
description: "Query customer related information"
doc_type: graphql
doc_category: storefront
doc_version: v20260901
source_url:
  html: 'https://developer.shopline.com/docs/storefront-api/customers/queries/customer'
  md: 'https://developer.shopline.com/docs/storefront-api/customers/queries/customer.md'
---
# customer

Query customer related information

- **API Version:** v20260901
- **API Type:** Storefront
- **API Protocol:** GraphQL
- **Operation Type:** Query

## Type Signature

`Customer`

## Arguments

* `customerAccessToken`

  [String!](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  Customer access token

## Returns

* `acceptsMarketing`

  [Boolean](https://developer.shopline.com/docs/storefront-api/common/scalars/boolean.md)

  Mail subscription or not

* `addresses`

  [AddressConnection](https://developer.shopline.com/docs/storefront-api/common-objects/objects/address-connection.md)

  Customer address list

* `createdAt`

  [Date!](https://developer.shopline.com/docs/storefront-api/common/scalars/date.md)

  Creation time

* `defaultAddress`

  [MailingAddress](https://developer.shopline.com/docs/storefront-api/common-objects/objects/mailing-address.md)

  Default address information

* `displayName`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  display name

* `email`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  User's Mail

* `eraseTime`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  eraseTime

* `firstName`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  User's Nickname

* `id`

  [ID!](https://developer.shopline.com/docs/storefront-api/common/scalars/id.md)

  Customer id

* `lastName`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  Last name

* `logoutStatus`

  [Int](https://developer.shopline.com/docs/storefront-api/common/scalars/int.md)

  logoutStatus(1:don't display;2:Display,3:To be delete)

* `orders`

  [OrderConnection](https://developer.shopline.com/docs/storefront-api/common-objects/objects/order-connection.md)

  The orders associated with the customer.

* `phone`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  Phone number

* `tags`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  Customer tag

* `updatedAt`

  [Date](https://developer.shopline.com/docs/storefront-api/common/scalars/date.md)

  Update time

## Code Example

```graphql
 {
	customer(customerAccessToken ) 
		 {
			# Customer fields
		}
}
```

## Error Handling

For detailed information about common codes, see [Status and error codes](https://developer.shopline.com/docs/apps/api-instructions-for-use/storefront-api/overview.md#status-and-error-codes).