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

# Retrieve a customer

`GET /v1/customers/{id}`

Retrieves the details of one of your customers.

## Path parameters

- `id` string, required

## Query parameters

- `include_org` boolean, nullable — Resolve a customer owned by a sibling partner in the same organization (PII opt-in). Defaults to `false`; a customer owned by another partner returns `404` unless this is `true` and the caller shares an organization with the owner. The owner is named on the response's `owner_partner_id`, and a sibling-owned customer's `metadata` is returned as `null`.

## Response `200`

An envelope wrapping a single customer object.

- CustomerBodyForCustomer — An envelope wrapping a single customer object.
  - `customer` Customer, required — A Customer object represents a customer of your business. Use it to track payments, store reusable payment methods, and reference the customer on checkout sessions, invoices, and subscriptions.
    - `customer_id` string, required — The unique identifier for the customer.
    - `owner_partner_id` string, nullable — The partner that owns this customer. When a customer is shared with you by another partner in your organization, this is that sibling partner; otherwise it is your own partner id.
    - `first_name` string, required — The customer's first name.
    - `last_name` string, required — The customer's last name.
    - `email` string, email, required — The customer's email address.
    - `phone` string, phone, nullable — The customer's phone number.
    - `employer` string, nullable — The customer's employer.
    - `shipping` ShippingAddress — A ShippingAddress represents the postal address a physical order is delivered to. It is referenced by checkout sessions and customers.
      - `shipping_address_id` string, required — Unique identifier for the shipping address.
      - `line1` string, nullable — The first line of the street address (e.g., street number and name).
      - `line2` string, nullable — The second line of the street address (e.g., apartment, suite, or unit).
      - `city` string, nullable — City, district, suburb, town, or village.
      - `state` string, nullable — State, county, province, or region.
      - `postal_code` string, nullable — ZIP or postal code.
      - `country` string, nullable — Two-letter country code (ISO 3166-1 alpha-2, e.g., `US`).
    - `metadata` object, nullable — Metadata associated with the customer.
    - `created_at` string, required — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
    - `test_mode` boolean, required — Whether the customer was created in test mode.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Validation Error
- `429` — Too Many Requests

---

[API](https://skmtc.dev/withflex/apis/flex-api.md) · [All operations](https://skmtc.dev/withflex/apis/flex-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withflex/flex-api/revisions/b1560fc2f199/schema)