---
title: "Show customer details"
method: GET
path: "/customer/{id}"
tags: ["Customer"]
---

# Show customer details

`GET /customer/{id}`

Retrieves the customer details, including reward balances.

**Required scope:** <code style="background:#e8f0fe;color:#1a73e8;padding:2px 8px;border-radius:12px;font-size:0.85em">customer:read</code>

## Path parameters

- `id` string, uuid, required

## Response `200`

OK

- CustomerDetail — The Customer object contains detailed information about the customer, including reward balances.
  - `id` string, uuid — Unique identifier for the customer.
  - `name` string — Full name of the customer.
  - `email` string, email — Customer's email address.
  - `phone` string — The contact phone number of the customer, excluding the country code indicator.
  - `phone_indicative` string — The country code indicator for the customer's phone number.
  - `fiscal_number` string — Customer's tax identification number or fiscal number.
  - `key` string — A customizable text field for users to input their own identifier for the customer.
  - `language` 'PT' | 'EN' | 'ES' — Preferred language for customer communications. Uses ISO 639-1 language codes.
  - `reward_balances` object[] — Reward balances across all reward accounts for this customer. Empty array if no reward accounts exist. See the [Rewards & Redemptions guide](/docs/guides/rewards-and-redemptions) for the full flow.
    - `account_id` string, uuid — The unique identifier of the reward account.
    - `available_balance` number — The available reward balance for this account.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/easypay/apis/easypay-payments-api.md) · [All operations](https://skmtc.net/easypay/apis/easypay-payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/easypay/easypay-payments-api/versions/cdf25a9ad7b2/schema)
