---
title: "Retrieve a customer"
method: GET
path: "/v1/customers"
tags: ["Customers"]
---

# Retrieve a customer

`GET /v1/customers`

Retrieve customer information by ID or email. View purchase history, subscriptions, and profile details.

## Query parameters

- `customer_id` string
- `email` string

## Response `200`

Successfully retrieved the customer

- CustomerEntity
  - `id` string, required — Unique identifier for the object.
  - `mode` 'test' | 'prod' | 'sandbox', required — String representing the environment.
  - `object` string, required — String representing the object’s type. Objects of the same type share the same value.
  - `email` string, required — Customer email address.
  - `name` string, nullable — Customer name.
  - `metadata` object, nullable — Additional metadata associated with the customer.
  - `country` string, nullable, required — The ISO 3166-1 alpha-2 country code for the customer.
  - `created_at` string, date-time, required — Creation date of the customer
  - `updated_at` string, date-time, required — Last updated date of the customer

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing API key
- `404` — Not Found - Resource does not exist

---

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