---
title: "List an account's existing subscriptions"
method: GET
path: "/subscriptions"
tags: ["Subscriptions"]
---

# List an account's existing subscriptions

`GET /subscriptions`

## Request

- Base URL: `https://api.purplegrain.com/api/v1`
- URL: `https://api.purplegrain.com/api/v1/subscriptions`
- Auth: HTTP bearer

List existing subscription records for the required `owner_id` and `owner_type` (`users` or `organizations`). Requires permission to manage that account, including write access in an assistant connection's grant. Returns plan, status, recorded price, interval and subscription dates; include=subscribable embeds the owner. Use page and per_page, following meta.next_page. Reading this list does not start, renew or cancel subscriptions or charge a payment.

## Query parameters

- `owner_id` string, required
- `owner_type` 'users' | 'organizations', required
- `page` integer
- `per_page` integer
- `include` string

## Response `200`

Subscriptions for the requested owner. When the `include` query parameter is used, the response may contain an `included` array (JSON:API) or inlined related resources (application/json).

- SubscriptionsIndexResponseAttributes: List subscriptions response for Accept application/json (attributes adapter).
  - `data` SubscriptionModelAttributes[]
    - `id` string
    - `type` string
    - `plan` 'provider'
    - `status` 'trialing' | 'active' | 'cancelled'
    - `services_limit` integer
    - `price_cents` integer
    - `interval` string
    - `payment_provider` 'mock' | 'stripe'
    - `current_period_start` string, date-time
    - `current_period_end` string, date-time
    - `trial_ends_at` string, date-time, nullable
    - `started_at` string, date-time, nullable
    - `cancelled_at` string, date-time, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `subscribable` object: Present when include=subscribable
  - `meta` PaginationMeta
    - `current_page` number
    - `next_page` number, nullable
    - `prev_page` number, nullable

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/purplegrain/apis/purple-grain-api.md) · [All operations](https://skmtc.dev/purplegrain/apis/purple-grain-api/llms.txt) · [OpenAPI document](https://skmtc.dev/purplegrain/apis/purple-grain-api/revisions/29c5c990d66e?raw)