Subscriptions

Get subscription

GET/v1/billing/subscriptions/{id}

curl --request GET \
  --url https://api.serverside.com/v1/billing/subscriptions/{id} \
  --header 'X-API-KEY: <api-key>'

{
  "success": true,
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "lastRenewal": "2026-01-15T09:30:00Z",
    "nextRenewal": "2026-01-15T09:30:00Z",
    "createdAt": "2026-01-15T09:30:00Z",
    "terminatedAt": "2026-01-15T09:30:00Z",
    "cycle": "HOURLY",
    "status": "ACTIVE",
    "items": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "subscriptionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "orderItemId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "provisionedId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "type": "BAREMETAL",
        "details": {},
        "title": "<string>",
        "subtotal": 123,
        "discountRate": 123,
        "terminatedAt": "2026-01-15T09:30:00Z",
        "isTerminated": true,
        "currency": "<string>"
      }
    ],
    "activeItems": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "subscriptionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "orderItemId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "provisionedId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "type": "BAREMETAL",
        "details": {},
        "title": "<string>",
        "subtotal": 123,
        "discountRate": 123,
        "terminatedAt": "2026-01-15T09:30:00Z",
        "isTerminated": true,
        "currency": "<string>"
      }
    ],
    "currency": "<string>"
  }
}

Authorizations

X-API-KEYstringheaderrequired
Organization API key, created in the cloud console at https://cloud.serverside.com and shown once. It authenticates as the organization.

Required permission: organization.billing.read

Path parameters

idstring<uuid>required

Response

200 · application/json

OK

successboolean
Allowed values:true
dataobject