---
title: "List user subscriptions (passthrough)"
method: GET
path: "/api/v1/subscriptions"
tags: ["subscriptions"]
---

# List user subscriptions (passthrough)

`GET /api/v1/subscriptions`

Returns all MaaSSubscription resources the user has access to, in a sanitised format safe for basic users. Proxied from the maas-api /v1/subscriptions endpoint.

## Response `200`

List of subscriptions

- object
  - `data` SubscriptionListItem[]
    - `subscription_id_header` string, required — Subscription name to use in the X-MaaS-Subscription header
    - `subscription_description` string, required — Human-readable description (falls back to display-name, then name)
    - `display_name` string — Display name from the openshift.io/display-name annotation
    - `priority` integer, required — Subscription priority (higher = higher priority)
    - `model_refs` ModelRefInfo[], required — Model references with rate limits
      - `name` string, required — Name of the MaaSModelRef
      - `display_name` string — Human-readable display name of the model (from openshift.io/display-name annotation)
      - `source` string — Model source identifier (internal or external)
      - `description` string — Human-readable description of the model
      - `namespace` string — Namespace where the MaaSModelRef lives
      - `token_rate_limits` object[]
        - `limit` integer, required — Maximum number of tokens allowed
        - `window` string, required — Time window (e.g., 1m, 1h, 24h)
      - `billing_rate` object
        - `per_token` string — Cost per token
    - `organization_id` string — Organization identifier for metering and billing
    - `cost_center` string — Cost center for usage attribution
    - `key_count` integer — Number of API keys associated with this subscription for the current user
    - `labels` object — Additional labels for tracking and metrics

## Other responses

- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/opendatahub-io/apis/maas-bff-api.md) · [All operations](https://skmtc.net/opendatahub-io/apis/maas-bff-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/opendatahub-io/maas-bff-api/versions/9112415ceeca/schema)