Get a single user subscription by ID (passthrough)¶

GET /api/v1/subscriptions/{id}

GET /maas/api/v1/subscriptions/{id}

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.

Authorization¶

bearerAuth

Parameters¶

Name	In	Type	Required	Description
`id`	path	string	Yes	The subscription_id_header to look up.

Responses¶

Status	Description	Response body
`200` OK	The subscription	object `application/json`
`401` Unauthorized	Unauthorized	None
`404` Not Found	Subscription not found	ErrorResponse `application/json`
`500` Internal Server Error	Internal Server Error	ErrorResponse `application/json`

200 OK response body

Property	Type	Required	Description
`data`	SubscriptionListItem	No

Example request¶

curl -X GET "/maas/api/v1/subscriptions/{id}" \
  -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.",
        "namespace": "maas-models",
        "token_rate_limits": [
          {
            "limit": 100000,
            "window": "24h"
          }
        ]
      }
    ]
  }
}