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

# List Subscriptions

`GET /v1/subscriptions`

Lists all subscriptions on the authenticated user's Lucid account. This endpoint is paginated.

## Response `200`

OK. Returns an array of subscriptions on the account.

- Subscription[]
  - `id` string, uuid, required — Subscription ID
  - `licenseTotal` integer — Total number of available licenses on the subscription and its addons. If there are unlimited licenses, this field will not be returned.
  - `licensesUsed` integer, required — Number of licenses currently assigned to users on the subscription
  - `trial` boolean, required — Whether this is a trial subscription
  - `start` string, date-time, required — Date and time when subscription started
  - `end` string, date-time, required — Date and time when subscription ends
  - `renewal` string, date-time, required — Date and time when subscription renewal happens

## Other responses

- `403` — Forbidden. Occurs when the user is not authorized to view subscriptions.

---

[API](https://skmtc.net/lucid/apis/lucid-rest-api.md) · [All operations](https://skmtc.net/lucid/apis/lucid-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lucid/lucid-rest-api/revisions/6a32cb9e1aa7/schema)