---
title: "List subscriptions and licenses"
method: GET
path: "/v1/billing/subscription"
tags: ["Billing"]
---

# List subscriptions and licenses

`GET /v1/billing/subscription`

Returns licensed service instances for the authenticated account, newest first. Each item has quantity one and can be grouped by SKU to calculate license counts.

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

OK

- object
  - `data` BillingSubscription[], required
    - `activated_at` string, date-time
    - `billing_interval` 'month' | 'year', required
    - `cancel_at` string, date-time
    - `currency` string, required
    - `device_id` string — Absent when the subscription is not tied to a device.
    - `fto` BillingSubscriptionFTO — Free To Own progress for the subscription's device. Applied months are counted from paid service invoices and can decrease when an invoice is refunded or voided.
      - `applied_months` integer, required
      - `required_months` integer, required
      - `status` 'pending' | 'active' | 'completed' | 'breached', required
    - `purchased_at` string, date-time
    - `quantity` integer, required
    - `scheduled_activation_at` string, date-time
    - `sku` string, required — Stable Slide service-model identifier used as the subscription SKU.
    - `status` 'pending_activation' | 'active' | 'canceled', required
    - `subscription_id` string, required — Slide service-instance identifier.
    - `unit_amount` integer, required — Recurring unit amount in the currency's smallest unit.
    - `usage_billed` boolean, required — Whether charges are based on metered consumption. Currently false for Slide subscriptions.
  - `pagination` Pagination, required
    - `next_offset` integer — Next offset to use for pagination. If this field is not present, that indicates there are no more items to fetch.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Internal server error

---

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