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

# Customer Subscriptions

`GET /v2/customers/{id}/subscriptions`

## Path parameters

- `id` string, required

## Query parameters

- `start` integer
- `limit` integer

## Response `200`

Successful Response

- SubscriptionOutList
  - `range` ResponseRange, required
    - `start` integer, required
    - `end` integer, required
    - `limit` integer, required
    - `count` integer, required
    - `has_more` boolean, required
  - `subscriptions` SubscriptionOut[], required
    - `id` string, required
    - `customer` string, required
    - `items` object, required
    - `status` 'incomplete' | 'active' | 'past_due' | 'unpaid' | 'canceled', required — An enumeration.
    - `payment_intent` string
    - `start_at` string, date, required
    - `free_until` string, date
    - `cancel_at` string, date
    - `methods_allowed` PaymentMethod[]
    - `card` string
    - `sepa` string

## Other responses

- `422` — Validation Error

---

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