---
url: https://docs.youcan.shop/store-admin/entities/customer.md
---
# Customer entity

The Customer entity at YouCan.

| Attribute Name | Type | Description |
| --- | --- | --- |
| id | string | Identifier (UUID) |
| first\_name | string, null | Customer first name |
| last\_name | string, null | Customer last name |
| full\_name | string, null | Customer full name (first + last) |
| email | string | Customer email address |
| avatar | string, null | URL of the customer avatar image |
| phone | string, null | Customer phone number |
| country | string, null | Customer country |
| region | string, null | Customer region |
| city | string, null | Customer city |
| notes | string, null | Internal notes about the customer |
| location | string, null | Computed location label (city + country) |
| created\_at | string | Creation date (ISO 8601, store timezone) |
| updated\_at | string | Last update date (ISO 8601, store timezone) |
| deleted\_at | string, null | Deletion date (ISO 8601), null if not deleted |
| links.edit | string | URL to edit the customer in the seller area |
| [address](#address) | array | Customer addresses (default include) |
| [orders](#orders) | array | Customer orders (available include) |

## Address

Array of [Address](./address.md) objects associated with the customer.

## Orders

Array of [Order](./order.md) objects placed by the customer. Use `?include=orders` to include.