---
title: "GET /subscriptions"
method: GET
path: "/subscriptions"
tags: ["subscriptions"]
---

# GET /subscriptions

`GET /subscriptions`

## Query parameters

- `id` string, text
- `user_id` string, uuid
- `status` string, public.subscription_status
- `metadata` string, jsonb
- `price_id` string, text
- `quantity` string, integer
- `cancel_at_period_end` string, boolean
- `created` string, timestamp with time zone
- `current_period_start` string, timestamp with time zone
- `current_period_end` string, timestamp with time zone
- `ended_at` string, timestamp with time zone
- `cancel_at` string, timestamp with time zone
- `canceled_at` string, timestamp with time zone
- `trial_start` string, timestamp with time zone
- `trial_end` string, timestamp with time zone
- `organization_id` string, uuid
- `select` string
- `order` string
- `offset` string
- `limit` string

## Headers

- `Range` string
- `Range-Unit` string
- `Prefer` 'count=none'

## Response `200`

OK

- Subscriptions[]
  - `id` string, text, required — Note: This is a Primary Key.<pk/>
  - `user_id` string, uuid
  - `status` 'trialing' | 'active' | 'canceled' | 'incomplete' | 'incomplete_expired' | 'past_due' | 'unpaid', public.subscription_status
  - `metadata` unknown
  - `price_id` string, text — Note: This is a Foreign Key to `prices.id`.<fk table='prices' column='id'/>
  - `quantity` integer
  - `cancel_at_period_end` boolean
  - `created` string, timestamp with time zone, required
  - `current_period_start` string, timestamp with time zone, required
  - `current_period_end` string, timestamp with time zone, required
  - `ended_at` string, timestamp with time zone
  - `cancel_at` string, timestamp with time zone
  - `canceled_at` string, timestamp with time zone
  - `trial_start` string, timestamp with time zone
  - `trial_end` string, timestamp with time zone
  - `organization_id` string, uuid, required — Note: This is a Foreign Key to `organization.id`.<fk table='organization' column='id'/>

## Other responses

- `206` — Partial Content

---

[API](https://skmtc.net/revent-app/apis/standard-public-schema.md) · [All operations](https://skmtc.net/revent-app/apis/standard-public-schema/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/revent-app/standard-public-schema/revisions/90ce877204f2/schema)