---
title: "Get Subscription"
method: GET
path: "/v1/subscriptions/{id}"
tags: ["Subscriptions"]
---

# Get Subscription

`GET /v1/subscriptions/{id}`

Retrieves details about a specific subscription on the account.

## Path parameters

- `id` string, uuid, required

## Response `200`

OK. Returns the subscription.

- Subscription — A subscription resource representing a Lucid product 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 or the subscription does not exist.

---

[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)