---
title: "Get customer"
method: GET
path: "/stores/{storeId}/customers/{customerId}"
tags: ["Customer"]
---

# Get customer

`GET /stores/{storeId}/customers/{customerId}`

Retrieves detailed information for a single customer in the specified store.
Requires the `stores.customers.view` permission.

## Path parameters

- `storeId` string, uuid, required
- `customerId` string, uuid, required

## Response `200`

The object was successfully returned.

- PublicCustomerResponse — Represents a default generic response for API endpoints.
  - `success` boolean, required — Indicates whether the operation or response was successful.
  - `message` string, nullable — A descriptive message providing additional context or information about the response.
  - `code` string, nullable — The error code (if there was an error) to use when referencing the error
  - `data` PublicCustomer — Represents a customer who is associated with your store.
    - `id` string, uuid, required — The unique identifier of the entity
    - `dateCreated` string, date-time, required — The date the entity was created
    - `emailAddress` string, required — The email address of the customer.
    - `status` string, required — The status of the customer.
    - `totalSpend` number, double, required — The total amount of money spent by the customer.
    - `averageSpend` number, double, required — The average spend amount calculated for the customer.
    - `totalOrders` number, double, required — The total number of orders placed by the customer.
    - `ipAddress` string, required — The IP address of the customer.
    - `balance` number, double, required — The customers balance
    - `externalIntegrations` object, required — Stores external integration details associated with the customer.
    - `affiliate` PublicStoreAffiliate — Represents the affiliate details for a public-facing store customer.
      - `id` string, uuid, required — The unique identifier of the entity
      - `dateCreated` string, date-time, required — The date the entity was created
      - `isEnabled` boolean, required — Indicates whether the store affiliate is enabled.
      - `link` string, required — Represents the URL linked to the affiliate.
      - `returnPercentage` integer, nullable — Represents the percentage of returns for the affiliated store.
      - `percentageOff` integer, nullable — Represents the percentage discount offered by the affiliate store.
      - `balance` number, double, required — Represents the current balance associated with the store affiliate.
    - `tickets` PublicTicket[], required — Represents a collection of tickets opened by the customer.
      - `id` string, uuid, required — The unique identifier of the entity
      - `dateCreated` string, date-time, required — The date the entity was created
      - `subject` string, required — The subject of the ticket
      - `status` 0 | 1 | 2 | 3 | 4, required — The different states of the ticket
      - `storeId` string, uuid, required — The store that the customer is having problems with
      - `customerId` string, uuid, required — The ID of the customer who opened the ticket
      - `emailAddress` string, required — The email address of the customer who opened the ticket
      - `entries` PublicTicketEntry[], required — All of the ticket messages/entries
        - `id` string, uuid, required — The unique identifier of the entity
        - `dateCreated` string, date-time, required — The date the entity was created
        - `message` string, required — The message the user has posted to the ticket
        - `name` string, required — The name of the user that posted the entry
    - `isBlocked` boolean, required — Whether this customer is blocked from purchasing on this store.
    - `blockedNote` string, nullable — An optional note explaining why the customer was blocked.
    - `blockedAt` string, date-time, nullable — The date the customer was blocked, if applicable.

## Other responses

- `400` — The provided form information is not valid, check that the provided data is valid. You can use the 'invalidFields' field to get the list of invalid fields or just use the 'message' field.
- `401` — You are not authorized, check your API key and try again.
- `403` — You are not authorized to access this endpoint, you may be missing an API key scope or be requesting a privileged endpoint.
- `404` — One of the objects referenced by the ID given in the URL or form was not found, check the ID and try again.

---

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