Get subscription details¶

GET /api/v1/subscription-info/{name}

GET /maas/api/v1/subscription-info/{name}

Returns detailed information about a specific subscription, including the MaaSSubscription resource, related MaaSModelRef resources, and associated MaaSAuthPolicy resources. K8s calls: GET /k8s/v1/maassubscription/:name, GET /k8s/v1/maasmodelref, GET /k8s/v1/maasauthpolicy

Authorization¶

bearerAuth

Parameters¶

Name	In	Type	Required	Description
`name`	path	string	Yes	Name of the MaaSSubscription resource

Responses¶

Status	Description	Response body
`200` OK	Subscription details with related resources	SubscriptionInfoResponse `application/json`
`401` Unauthorized	Unauthorized	None
`403` Forbidden	Forbidden	None
`404` Not Found	Subscription not found	ErrorResponse `application/json`
`500` Internal Server Error	Internal Server Error	ErrorResponse `application/json`

Example request¶

curl -X GET "/maas/api/v1/subscription-info/{name}" \
  -H "Authorization: Bearer $TOKEN"

Example response¶

200 OK, application/json

{
  "subscription": {
    "name": "premium-team-sub",
    "namespace": "maas-system",
    "phase": "Active",
    "inferencePriority": 10,
    "owner": {
      "groups": [
        {
          "name": "premium-users"
        }
      ]
    },
    "modelRefs": [
      {
        "name": "llama-2-7b-chat",
        "namespace": "maas-models",
        "tokenRateLimits": [
          {
            "limit": 100000,
            "window": "24h"
          }
        ]
      }
    ],
    "tokenMetadata": {
      "organizationId": "org-123",
      "costCenter": "engineering"
    },
    "creationTimestamp": "2025-03-01T10:00:00Z"
  },
  "modelRefs": [
    {
      "name": "llama-2-7b-chat",
      "namespace": "maas-models",
      "modelRef": {
        "kind": "LLMInferenceService",
        "name": "llama-2-7b-chat"
      },
      "phase": "Ready",
      "endpoint": "https://llama-2-7b-chat.example.com"
    }
  ],
  "authPolicies": [
    {
      "name": "premium-team-sub-policy",
      "namespace": "maas-system",
      "phase": "Active",
      "modelRefs": [
        {
          "name": "llama-2-7b-chat",
          "namespace": "maas-models"
        }
      ],
      "subjects": {
        "groups": [
          {
            "name": "premium-users"
          }
        ]
      }
    }
  ]
}