STACKIT · Schema

marketplace.subscription.v1.Subscription

CompanyCloud ComputingSovereign CloudInfrastructure-as-a-ServiceKubernetesData ProtectionEuropeColocation

Properties

Name Type Description
approvalTimeout string Period between the subscription was created until the approval needs to happen.
autoRenewal boolean If true, the the subscription will extend its validity automatically at the end of the current period.
lifecycleState string
orderedAt string When the subscription was ordered.
organizationId string The UUID of the organization.
product object The product to the subscription.
projectId string The UUID of the project.
subscriptionId string The UUID of the subscription.
terminatesAt string Timestamp when the subscription will finally terminate.
validFrom string Timestamp when the subscription validity has started.
validUntil string Timestamp when the current subscription validity will end. May be automatically renewed.
View JSON Schema on GitHub

JSON Schema

stackit-marketplace-subscription-v1-subscription-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/stackit/json-schema/stackit-marketplace-subscription-v1-subscription-schema.json",
  "title": "marketplace.subscription.v1.Subscription",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/stackit-consumers-api-openapi.yml#/components/schemas/marketplace.subscription.v1.Subscription",
  "properties": {
    "approvalTimeout": {
      "description": "Period between the subscription was created until the approval needs to happen.",
      "readOnly": true,
      "type": "string"
    },
    "autoRenewal": {
      "description": "If true, the the subscription will extend its validity automatically at the end of the current period.",
      "readOnly": true,
      "type": "boolean"
    },
    "lifecycleState": {
      "enum": [
        "STATE_UNSPECIFIED",
        "SUBSCRIPTION_PENDING",
        "SUBSCRIPTION_ACTIVE",
        "SUBSCRIPTION_INACTIVE",
        "SUBSCRIPTION_CANCELLING",
        "SUBSCRIPTION_CANCELLED",
        "SUBSCRIPTION_REJECTED",
        "SUBSCRIPTION_APPROVAL_TIMED_OUT"
      ],
      "readOnly": true,
      "type": "string"
    },
    "orderedAt": {
      "description": "When the subscription was ordered.",
      "readOnly": true,
      "type": "string"
    },
    "organizationId": {
      "description": "The UUID of the organization.",
      "readOnly": true,
      "type": "string"
    },
    "product": {
      "allOf": [
        {
          "$ref": "#/$defs/marketplace.subscription.v1.SubscriptionProduct"
        }
      ],
      "description": "The product to the subscription.",
      "readOnly": true
    },
    "projectId": {
      "description": "The UUID of the project.",
      "readOnly": true,
      "type": "string"
    },
    "subscriptionId": {
      "description": "The UUID of the subscription.",
      "readOnly": true,
      "type": "string"
    },
    "terminatesAt": {
      "description": "Timestamp when the subscription will finally terminate.",
      "readOnly": true,
      "type": "string"
    },
    "validFrom": {
      "description": "Timestamp when the subscription validity has started.",
      "readOnly": true,
      "type": "string"
    },
    "validUntil": {
      "description": "Timestamp when the current subscription validity will end. May be automatically renewed.",
      "readOnly": true,
      "type": "string"
    }
  },
  "required": [
    "organizationId",
    "projectId",
    "subscriptionId",
    "product",
    "lifecycleState",
    "orderedAt"
  ],
  "type": "object",
  "$defs": {
    "marketplace.subscription.v1.Assets": {
      "properties": {
        "endUserLicenseAgreement": {
          "$ref": "#/$defs/marketplace.subscription.v1.File"
        },
        "productDescription": {
          "$ref": "#/$defs/marketplace.subscription.v1.File"
        },
        "serviceCertificate": {
          "$ref": "#/$defs/marketplace.subscription.v1.File"
        },
        "serviceLevelAgreement": {
          "$ref": "#/$defs/marketplace.subscription.v1.File"
        }
      },
      "type": "object"
    },
    "marketplace.subscription.v1.File": {
      "properties": {
        "version": {
          "$ref": "#/$defs/marketplace.subscription.v1.File_LocalizedVersion"
        }
      },
      "type": "object"
    },
    "marketplace.subscription.v1.File_LocalizedVersion": {
      "properties": {
        "de": {
          "description": "The file version matching the file name (localized).",
          "type": "string"
        },
        "en": {
          "description": "The file version matching the file name (localized).",
          "type": "string"
        }
      },
      "type": "object"
    },
    "marketplace.subscription.v1.SubscriptionProduct": {
      "properties": {
        "assets": {
          "$ref": "#/$defs/marketplace.subscription.v1.Assets"
        },
        "deliveryMethod": {
          "description": "The product delivery method/type. For reference: SAAS - Software as a Service, CLOUD_IMAGE - STACKIT Cloud Image",
          "enum": [
            "SAAS",
            "CONTAINER_IMAGE",
            "CLOUD_IMAGE",
            "PROFESSIONAL_SERVICE"
          ],
          "readOnly": true,
          "type": "string"
        },
        "lifecycleState": {
          "description": "The lifecycle state of the product.",
          "enum": [
            "PRODUCT_LIVE",
            "PRODUCT_PENDING_APPROVAL",
            "PRODUCT_PREVIEW"
          ],
          "readOnly": true,
          "type": "string"
        },
        "noticePeriod": {
          "description": "The cancellation notice period of the subscription.",
          "type": "string"
        },
        "planId": {
          "description": "The user-readable plan ID of a pricing option.",
          "type": "string"
        },
        "priceType": {
          "description": "The product's price type.",
          "enum": [
            "CONTRACT",
            "FREE",
            "FREE_TRIAL",
            "BYOL",
            "PAYG"
          ],
          "readOnly": true,
          "type": "string"
        },
        "pricingPlan": {
          "description": "Additional price type information.",
          "type": "string"
        },
        "productId": {
          "description": "The user-readable ID of the product.",
          "type": "string"
        },
        "productName": {
          "description": "The name of the product.",
          "type": "string"
        },
        "rate": {
          "description": "The price of the product (per unit).",
          "type": "string"
        },
        "validityPeriod": {
          "description": "The period the subscription is valid for before it will be renewed.",
          "type": "string"
        },
        "vendorName": {
          "description": "The product vendor's name.",
          "type": "string"
        },
        "vendorPlanId": {
          "description": "The vendor provided plan ID.",
          "type": "string"
        },
        "vendorProductId": {
          "description": "The vendor provided prduct ID.",
          "type": "string"
        },
        "vendorWebsiteUrl": {
          "description": "The vendor's website.",
          "type": "string"
        }
      },
      "required": [
        "deliveryMethod",
        "lifecycleState",
        "planId",
        "priceType",
        "pricingPlan",
        "productId",
        "productName",
        "vendorName",
        "vendorWebsiteUrl",
        "validityPeriod",
        "noticePeriod",
        "rate"
      ],
      "type": "object"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/stackit-marketplace-subscription-v1-subscription"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.