---
title: "Returns information about the Charthop subscription for the given customer"
method: GET
path: "/v1/customer/{customerId}/subscription"
tags: ["customer"]
---

# Returns information about the Charthop subscription for the given customer

`GET /v1/customer/{customerId}/subscription`

## Path parameters

- `customerId` string, required

## Response `200`

successful operation

- Subscription
  - `nextInvoiceAt` string, required — Timestamp when the next invoice will be generated
  - `plan` Plan, required
    - `id` string, required — unique Stripe identifier for this plan
    - `name` string, required — human-readable nickname for this plan
    - `interval` 'DAY' | 'WEEK' | 'MONTH' | 'YEAR', required — interval for billing on this plan
    - `intervalCount` integer, required — number of intervals, for example 3 for quarterly billing
    - `tiers` PlanTier[], required — pricing tiers, per employee per interval
      - `upTo` integer — headcount up to this level is charged at the below rate
      - `unitAmount` number, required — PEPM rate
    - `stripeProductId` string, required — stripe product id that this plan belongs to
  - `paymentInfo` PaymentInfo, required
    - `paymentType` 'CREDIT_CARD' | 'INVOICE', required — indicates how the customer has decided to pay; one of CREDIT_CARD, INVOICE
    - `creditCardEndDigits` string — if the customer has indicated they wish to pay by credit card, the last four digits of the credit card they are paying with. Null if the customer is paying by invoice.
    - `brand` string — if the customer has indicated they wish to pay by credit card, the brand of the credit card they are paying with. Null if the customer is paying by invoice.

## Other responses

- `400` — bad request
- `404` — not found

---

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