---
title: "Get User Subscriptions"
method: GET
path: "/v3/users/{app_user_id}/subscriptions"
tags: ["Users V3"]
---

# Get User Subscriptions

`GET /v3/users/{app_user_id}/subscriptions`

Returns the user's full, alias-aware subscription history from the subscriptions store. Requires users:read scope.

## Path parameters

- `app_user_id` string, required — App user identifier

## Query parameters

- `application_id` string, required — Application ID

## Response `200`

Success

- object
  - `object` 'user_subscriptions', required
  - `app_user_id` string, required
  - `data` object[], required
    - `subscription_id` string, required
    - `product_id` string, required
    - `product_type` 'consumable' | 'nonConsumable' | 'autorenewable' | 'nonRenewable', required
    - `store` string, required
    - `transaction_id` string, required
    - `state` 'active' | 'inGracePeriod' | 'expired' | 'inBillingRetryPeriod' | 'revoked', required
    - `is_active` boolean, required
    - `is_lifetime` boolean, required
    - `will_renew` boolean, required
    - `offer_type` string, nullable, required
    - `starts_at` string, nullable, required — ISO 8601 timestamp the subscription first started
    - `renewed_at` string, nullable, required
    - `expires_at` string, nullable, required — ISO 8601 current period end; null for lifetime/open-ended
    - `original_purchase_date` string, nullable, required
    - `amount` number, nullable, required
    - `currency` string, nullable, required
    - `invoice_id` string, nullable, required
    - `invoice_url` string, nullable, required
    - `metadata` Superwall1apiSchema1v21JsonObject, required — unresolved $ref

## Other responses

- `400` — The request did not match the expected schema
- `401` — No API key was provided in the request
- `403` — The API key does not have permission to perform this action
- `404` — The requested resource was not found
- `429` — Too many requests have been made in a short period
- `500` — An unexpected error occurred on the server
- `502` — The upstream subscriptions service request failed

---

[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-service-production.skmtc.workers.dev/v1/apis/superwall/superwall-api-v2/revisions/e04f76c478af/schema)