---
title: "List Customer Subscriptions"
method: GET
path: "/revenuecat/projects/{project_id}/customers/{customer_id}/subscriptions"
tags: ["RevenueCat V2 (compatible)"]
---

# List Customer Subscriptions

`GET /revenuecat/projects/{project_id}/customers/{customer_id}/subscriptions`

Lists the customer's subscriptions (RevenueCat v2 subscription objects) with current, clock-correct status, alias-aware across the customer's identity group. Requires customers:read scope.

## Path parameters

- `project_id` string, required
- `customer_id` string, required — Customer ID (the app user id)

## Query parameters

- `limit` string
- `starting_after` string — Pagination cursor: the id of the last item on the previous page

## Response `200`

Success

- object
  - `object` 'list', required
  - `items` object[], required
    - `object` 'subscription', required
    - `id` string, required
    - `customer_id` string, required
    - `original_customer_id` string, required
    - `product_id` string, required
    - `starts_at` number, required
    - `current_period_starts_at` number, required
    - `current_period_ends_at` number, nullable, required
    - `ends_at` number, nullable, required
    - `gives_access` boolean, required
    - `pending_payment` boolean, required
    - `auto_renewal_status` 'will_renew' | 'will_not_renew', required
    - `status` 'trialing' | 'active' | 'expired' | 'in_grace_period' | 'in_billing_retry', required
    - `total_revenue_in_usd` unknown, required
    - `presented_offering_id` unknown, required
    - `entitlements` object, required
      - `object` 'list', required
      - `items` object[], required
        - `object` 'entitlement', required
        - `project_id` string, required
        - `id` string, required
        - `lookup_key` string, required
        - `display_name` string, nullable, required
        - `created_at` number, nullable, required
      - `next_page` string, nullable, required
      - `url` string, required
    - `environment` 'production' | 'sandbox', required
    - `store` 'app_store' | 'play_store' | 'stripe' | 'superwall_mock', required
    - `store_subscription_identifier` string, required
    - `ownership` 'purchased', required
    - `pending_changes` unknown, required
    - `country` unknown, required
    - `management_url` string, nullable, required
  - `next_page` string, nullable, required
  - `url` string, required

## Other responses

- `400` — The request did not match the expected schema | The request was invalid or malformed
- `401` — No API key was provided in the request | The API key does not have a valid format | The API key is invalid or has been revoked | An error occurred while validating the API key | The session cookie is invalid or expired
- `403` — The API key does not have permission for this action (RevenueCat-compatible) | The API key does not have permission to perform this action
- `404` — The requested resource was not found (RevenueCat-compatible error shape)
- `429` — Too many requests have been made in a short period
- `500` — An unexpected server error occurred (RevenueCat-compatible error shape)
- `502` — The upstream subscriptions service failed (RevenueCat-compatible error shape)

## Changes

- **2026-09-09** `217c96dc9a29` — 21 breaking, 4 warning, 56 info
  - the response's body type changed from `object` to no type for status `403`
  - the `code` response's property type changed from `string` to no type for status `429`
  - the `doc_url` response's property type changed from `string` to no type for status `404`
  - the `doc_url` response's property type changed from `string` to no type for status `500`
  - …77 more
  - …this revision’s changelog is incomplete

[Change history](https://skmtc.dev/superwall/apis/superwall-api-v2/changes/revenuecat/projects/:project_id/customers/:customer_id/subscriptions/get.md)

---

[API](https://skmtc.dev/superwall/apis/superwall-api-v2.md) · [All operations](https://skmtc.dev/superwall/apis/superwall-api-v2/llms.txt) · [OpenAPI document](https://skmtc.dev/superwall/apis/superwall-api-v2/revisions/7b4c0e9ccb3a?raw)