Skip to content

List user subscriptions (passthrough)

GET /api/v1/subscriptions

GET /maas/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.

Authorization

Responses

Status Description Response body
200 OK

List of subscriptions

object

application/json

401 Unauthorized

Unauthorized

None
500 Internal Server Error

Internal Server Error

ErrorResponse

application/json

200 OK response body

Property Type Required Description
data array of SubscriptionListItem No

Example request

curl -X GET "/maas/api/v1/subscriptions" \
  -H "Authorization: Bearer $TOKEN"

Example response

200 OK, application/json

{
  "data": [
    {
      "subscription_id_header": "premium-team-sub",
      "subscription_description": "Premium Team Subscription",
      "display_name": "Premium Team",
      "inference_priority": 10,
      "cost_center": "engineering",
      "organization_id": "org-123",
      "key_count": 10,
      "model_refs": [
        {
          "name": "granite-3-8b-instruct",
          "display_name": "Granite 3 8B Instruct",
          "source": "internal",
          "description": "Granite 3 8B Instruct is a large language model that is used for advanced tasks.",
          "namespace": "maas-models",
          "token_rate_limits": [
            {
              "limit": 100000,
              "window": "24h"
            }
          ]
        },
        {
          "name": "flan-t5-small",
          "display_name": "Flan T5 Small",
          "source": "external",
          "description": "Flan T5 Small is a small language model that is used for basic tasks.",
          "namespace": "maas-models",
          "token_rate_limits": [
            {
              "limit": 200000,
              "window": "24h"
            }
          ]
        }
      ]
    },
    {
      "subscription_id_header": "basic-team-sub",
      "subscription_description": "Basic Team Subscription",
      "display_name": "Basic Team",
      "inference_priority": 1,
      "key_count": 5,
      "model_refs": [
        {
          "name": "flan-t5-small",
          "display_name": "Flan T5 Small",
          "description": "Flan T5 Small is a small language model that is used for basic tasks.",
          "source": "external",
          "namespace": "maas-models",
          "token_rate_limits": [
            {
              "limit": 10000,
              "window": "24h"
            }
          ]
        }
      ]
    }
  ]
}