---
title: "GET /subscriptions/{id}/customer"
method: GET
path: "/subscriptions/{id}/customer"
tags: ["Subscriptions"]
---

# GET /subscriptions/{id}/customer

`GET /subscriptions/{id}/customer`

Retrieve a customer on a subscription

## Path parameters

- `id` integer, required

## Response `200`

Successful operation

- CustomerService — Customer
  - `id` integer — The SamCart ID of the customer
  - `first_name` string, nullable — The first name of the customer
  - `last_name` string, nullable — The last name of the customer
  - `email` string, email — The email address of the customer
  - `phone` string, nullable — The phone number of the customer
  - `customer_tags` object[] — The tags applied to the customer
    - `name` string — The name of the customer tag
  - `lifetime_value` integer — The lifetime value (in cents) of the customer. Value is for live data only
  - `updated_at` string, date-time — The UTC date and time when the customer information was updated
  - `created_at` string, date-time — The UTC date and time when the customer was created
  - `addresses` AddressService[] — Addresses associated with the customer
    - `type` 'shipping' | 'billing' — The type of address for the customer
    - `street` string — The street for the customer
    - `postal_code` string — The postal code for the customer
    - `city` string — The city name for the customer
    - `state` string, nullable — The 2-letter state code for US customers. For non-US addresses this value will be null.
    - `region` string, nullable — The optional sub-divided area of a country for international customers. For US addresses this value will be null.
    - `country` string — The country for the customer

## Other responses

- `404` — Subscription or customer could not be found

---

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