v27

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-08-01304498.9 KB
subscriptions

Get a single user subscription by ID (passthrough)

Returns the MaaSSubscription the authenticated user has access to for the given subscription_id_header. Returns 404 if the subscription does not exist or the user has no access to it.

get/api/v1/subscriptions/{id}

Path parameters

idstring required

The subscription_id_header to look up.

Response

The subscription

Example response

{
  "data": {
    "subscription_id_header": "premium-team-sub",
    "subscription_description": "Premium Team Subscription",
    "display_name": "Premium Team",
    "priority": 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"
          }
        ],
        "billing_rate": {
          "per_token": "0.001"
        }
      }
    ],
    "organization_id": "premium-org",
    "cost_center": "engineering",
    "key_count": 10,
    "labels": {
      "env": "production"
    }
  }
}