Kong · Schema

BillingSubscriptionChangeResponse

Response for changing a subscription.

API GatewayAI GatewayAI ConnectivityAgent GatewayEvent GatewayMCP RegistryService MeshLLMKafkaKonnectOpen Source

Properties

Name Type Description
current object The current subscription before the change.
next object The new state of the subscription after the change.
View JSON Schema on GitHub

JSON Schema

kong-billingsubscriptionchangeresponse-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/BillingSubscriptionChangeResponse",
  "title": "BillingSubscriptionChangeResponse",
  "description": "Response for changing a subscription.",
  "type": "object",
  "properties": {
    "current": {
      "description": "The current subscription before the change.",
      "type": "object",
      "properties": {
        "id": {
          "description": "ULID (Universally Unique Lexicographically Sortable Identifier).",
          "type": "string",
          "example": "01G65Z755AFWAKHE12NY0CQ9FH",
          "pattern": "^[0-7][0-9A-HJKMNP-TV-Z]{25}$",
          "readOnly": true,
          "title": "ULID"
        },
        "labels": {
          "$ref": "#/components/schemas/Labels"
        },
        "created_at": {
          "description": "An ISO-8601 timestamp representation of entity creation date.",
          "type": "string",
          "format": "date-time",
          "example": "2023-01-01T01:01:01.001Z",
          "readOnly": true,
          "title": "RFC3339 Date-Time"
        },
        "updated_at": {
          "description": "An ISO-8601 timestamp representation of entity last update date.",
          "type": "string",
          "format": "date-time",
          "example": "2023-01-01T01:01:01.001Z",
          "readOnly": true,
          "title": "RFC3339 Date-Time"
        },
        "deleted_at": {
          "description": "An ISO-8601 timestamp representation of entity deletion date.",
          "type": "string",
          "format": "date-time",
          "example": "2023-01-01T01:01:01.001Z",
          "readOnly": true,
          "title": "RFC3339 Date-Time"
        },
        "customer_id": {
          "description": "The customer ID of the subscription.",
          "type": "string",
          "example": "01G65Z755AFWAKHE12NY0CQ9FH",
          "pattern": "^[0-7][0-9A-HJKMNP-TV-Z]{25}$",
          "readOnly": true,
          "title": "Customer ID"
        },
        "plan_id": {
          "description": "The plan ID of the subscription.\nSet if subscription is created from a plan.",
          "type": "string",
          "example": "01G65Z755AFWAKHE12NY0CQ9FH",
          "pattern": "^[0-7][0-9A-HJKMNP-TV-Z]{25}$",
          "readOnly": true,
          "title": "Plan ID"
        },
        "billing_anchor": {
          "description": "A billing anchor is the fixed point in time that determines the subscription's recurring billing cycle.\nIt affects when charges occur and how prorations are calculated.\nCommon anchors:\n- Calendar month (1st of each month): `2025-01-01T00:00:00Z`\n- Subscription anniversary (day customer signed up)\n- Custom date (customer-specified day)",
          "type": "string",
          "format": "date-time",
          "example": "2023-01-01T01:01:01.001Z",
          "readOnly": true,
          "title": "Billing anchor"
        },
        "status": {
          "description": "The status of the subscription.",
          "type": "string",
          "enum": [
            "active",
            "inactive",
            "canceled",
            "scheduled"
          ],
          "readOnly": true,
          "title": "Status",
          "x-speakeasy-unknown-values": "allow"
        }
      },
      "required": [
        "id",
        "created_at",
        "updated_at",
        "customer_id",
        "billing_anchor",
        "status"
      ]
    },
    "next": {
      "description": "The new state of the subscription after the change.",
      "type": "object",
      "properties": {
        "id": {
          "description": "ULID (Universally Unique Lexicographically Sortable Identifier).",
          "type": "string",
          "example": "01G65Z755AFWAKHE12NY0CQ9FH",
          "pattern": "^[0-7][0-9A-HJKMNP-TV-Z]{25}$",
          "readOnly": true,
          "title": "ULID"
        },
        "labels": {
          "$ref": "#/components/schemas/Labels"
        },
        "created_at": {
          "description": "An ISO-8601 timestamp representation of entity creation date.",
          "type": "string",
          "format": "date-time",
          "example": "2023-01-01T01:01:01.001Z",
          "readOnly": true,
          "title": "RFC3339 Date-Time"
        },
        "updated_at": {
          "description": "An ISO-8601 timestamp representation of entity last update date.",
          "type": "string",
          "format": "date-time",
          "example": "2023-01-01T01:01:01.001Z",
          "readOnly": true,
          "title": "RFC3339 Date-Time"
        },
        "deleted_at": {
          "description": "An ISO-8601 timestamp representation of entity deletion date.",
          "type": "string",
          "format": "date-time",
          "example": "2023-01-01T01:01:01.001Z",
          "readOnly": true,
          "title": "RFC3339 Date-Time"
        },
        "customer_id": {
          "description": "The customer ID of the subscription.",
          "type": "string",
          "example": "01G65Z755AFWAKHE12NY0CQ9FH",
          "pattern": "^[0-7][0-9A-HJKMNP-TV-Z]{25}$",
          "readOnly": true,
          "title": "Customer ID"
        },
        "plan_id": {
          "description": "The plan ID of the subscription.\nSet if subscription is created from a plan.",
          "type": "string",
          "example": "01G65Z755AFWAKHE12NY0CQ9FH",
          "pattern": "^[0-7][0-9A-HJKMNP-TV-Z]{25}$",
          "readOnly": true,
          "title": "Plan ID"
        },
        "billing_anchor": {
          "description": "A billing anchor is the fixed point in time that determines the subscription's recurring billing cycle.\nIt affects when charges occur and how prorations are calculated.\nCommon anchors:\n- Calendar month (1st of each month): `2025-01-01T00:00:00Z`\n- Subscription anniversary (day customer signed up)\n- Custom date (customer-specified day)",
          "type": "string",
          "format": "date-time",
          "example": "2023-01-01T01:01:01.001Z",
          "readOnly": true,
          "title": "Billing anchor"
        },
        "status": {
          "description": "The status of the subscription.",
          "type": "string",
          "enum": [
            "active",
            "inactive",
            "canceled",
            "scheduled"
          ],
          "readOnly": true,
          "title": "Status",
          "x-speakeasy-unknown-values": "allow"
        }
      },
      "required": [
        "id",
        "created_at",
        "updated_at",
        "customer_id",
        "billing_anchor",
        "status"
      ]
    }
  },
  "required": [
    "current",
    "next"
  ]
}