---
title: "Retrieves a single customer."
method: GET
path: "/admin/customers/{id:\\\\d+}.json"
tags: ["Customer"]
---

# Retrieves a single customer.

`GET /admin/customers/{id:\\d+}.json`

## Path parameters

- `customer_id` integer, required

## Query parameters

- `fields` string

## Response `200`

OK

- CustomerDto
  - `accepts_marketing` boolean — Whether the customer has consented to receive marketing material via email.
  - `addresses` CustomerAddressDetail[] — A list of the ten most recently updated addresses for the customer.
    - `address1` string — The customer's mailing address.
    - `address2` string — An additional field for the customer's mailing address.
    - `city` string — The customer's city, town, or village.
    - `company` string — The customer's company.
    - `country` string — The customer's country.
    - `country_code` string — The two-letter country code corresponding to the customer's country.
    - `country_id` integer — A unique identifier for the customer.
    - `country_name` string — The customer's normalized country name.
    - `cpf_number` string — Brazil CPF Number
    - `cpf_or_cnpj_number` string — CPF/CNPJ number
    - `created_at` string, date-time — Created at time
    - `default` boolean — Whether this address is the default address for the customer.
    - `first_name` string — The customer's first name.
    - `id` integer — A unique identifier for the address.
    - `last_name` string — The customer's last name.
    - `latitude` number — Latitude
    - `longitude` number — Longtitude
    - `name` string — Address name
    - `phone` string — Phone number Example 555-555-5555
    - `province` string — Province
    - `province_code` string — The code for the region of the address, such as the province, state, or district. For example QC for Quebec, Canada.
    - `updated_at` string, date-time — Updated at time
    - `zip` string — ZIP
  - `average_spent` number — The average amount of money that the customer has spent across their order history.
  - `created_at` string, date-time — The date and time ([ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601)) when the customer was created.
  - `currency` string — The three-letter code ([ISO 4217 format](https://en.wikipedia.org/wiki/ISO_4217)) 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.
  - `default_address` CustomerAddressDetail
    - `address1` string — The customer's mailing address.
    - `address2` string — An additional field for the customer's mailing address.
    - `city` string — The customer's city, town, or village.
    - `company` string — The customer's company.
    - `country` string — The customer's country.
    - `country_code` string — The two-letter country code corresponding to the customer's country.
    - `country_id` integer — A unique identifier for the customer.
    - `country_name` string — The customer's normalized country name.
    - `cpf_number` string — Brazil CPF Number
    - `cpf_or_cnpj_number` string — CPF/CNPJ number
    - `created_at` string, date-time — Created at time
    - `default` boolean — Whether this address is the default address for the customer.
    - `first_name` string — The customer's first name.
    - `id` integer — A unique identifier for the address.
    - `last_name` string — The customer's last name.
    - `latitude` number — Latitude
    - `longitude` number — Longtitude
    - `name` string — Address name
    - `phone` string — Phone number Example 555-555-5555
    - `province` string — Province
    - `province_code` string — The code for the region of the address, such as the province, state, or district. For example QC for Quebec, Canada.
    - `updated_at` string, date-time — Updated at time
    - `zip` string — ZIP
  - `email` string — The unique email address of the customer. Attempting to assign the same email address to multiple customers returns an error.
  - `first_name` string — The customer's first name.
  - `id` integer — A unique identifier for the customer.
  - `last_name` string — The customer's last name.
  - `last_order_at` string, date-time — The date and time ([ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601)) when the customer purchase a last order
  - `last_order_id` integer — The ID of the customer's last order.
  - `last_order_name` string — The name of the customer's last order. This is directly related to the name field on the Order resource.
  - `last_sent_abandoned_email_at` string, date-time — The date and time ([ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601)) when the last abandoned checkout email was sent to this customer
  - `note` string — A note about the customer.
  - `orders_count` integer — The number of orders associated with this customer.
  - `phone` string — The unique phone number ([E.164 format](https://en.wikipedia.org/wiki/E.164)) 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. The following formats are all valid: * 6135551212 * +16135551212 * (613)555-1212 * +1 613-555-1212
  - `state` string — The state of the customer's account with a shop. Default value: disabled. Valid values: * **disabled**: The customer doesn't have an active account. Customer acounts can be disabled from the ShopBase admin at any time. * **invited**: The customer has received an emailed invite to create an account. * **enabled**: The customer has created an account. * **declined**: The customer declined the email invite to create an account.
  - `tags` string — Tags that the shop owner has attached to the customer, formatted as a string of comma-separated values.
  - `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.
  - `total_spent` number — The total amount of money that the customer has spent across their order history.
  - `updated_at` string, date-time — The date and time ([ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601)) when the customer information was last updated.
  - `verified_email` boolean — Whether the customer has verified their email address.

---

[API](https://skmtc.net/shopbase/apis/shopbase-internal-api.md) · [All operations](https://skmtc.net/shopbase/apis/shopbase-internal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shopbase/shopbase-internal-api/revisions/353ccde6240d/schema)