List subscriptions

curl --request GET \
  --url https://api.altostrat.io/workspaces/{workspaceId}/billing-accounts/{billingAccountId}/subscriptions \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "sub_a1b2c3d4e5f6g7h8",
      "billing_account_id": "cus_a1b2c3d4e5f6g7h8",
      "status": "active",
      "currency": "usd",
      "product_quantities": {
        "locations": {
          "price_id": "price_123abc",
          "quantity": 10,
          "interval": "month"
        },
        "users": {
          "price_id": "price_456def",
          "quantity": 50,
          "interval": "month"
        }
      },
      "metadata": {
        "order_id": "6735"
      },
      "current_period_start": "2025-10-15T00:00:00Z",
      "current_period_end": "2025-11-15T00:00:00Z",
      "created_at": "2025-10-15T12:30:00Z",
      "updated_at": "2025-10-20T09:00:00Z"
    }
  ],
  "has_more": false
}

GET

workspaces

{workspaceId}

billing-accounts

{billingAccountId}

subscriptions

List subscriptions

curl --request GET \
  --url https://api.altostrat.io/workspaces/{workspaceId}/billing-accounts/{billingAccountId}/subscriptions \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "sub_a1b2c3d4e5f6g7h8",
      "billing_account_id": "cus_a1b2c3d4e5f6g7h8",
      "status": "active",
      "currency": "usd",
      "product_quantities": {
        "locations": {
          "price_id": "price_123abc",
          "quantity": 10,
          "interval": "month"
        },
        "users": {
          "price_id": "price_456def",
          "quantity": 50,
          "interval": "month"
        }
      },
      "metadata": {
        "order_id": "6735"
      },
      "current_period_start": "2025-10-15T00:00:00Z",
      "current_period_end": "2025-11-15T00:00:00Z",
      "created_at": "2025-10-15T12:30:00Z",
      "updated_at": "2025-10-20T09:00:00Z"
    }
  ],
  "has_more": false
}

Authorizations

Authorization

string

header

required

Enter your JWT in the format: Bearer {token}

Path Parameters

workspaceId

string

required

The ID of the workspace.

Example:

"ws_a1b2c3d4e5f6g7h8"

billingAccountId

string

required

The ID of the billing account, which corresponds to a Stripe Customer ID (cus_...).

Example:

"cus_a1b2c3d4e5f6g7h8"

Response

A list of subscription objects.

data

object[]

Show child attributes

data.id

string

Unique identifier for the subscription (Stripe Subscription ID), prefixed with sub_.

Example:

"sub_a1b2c3d4e5f6g7h8"

data.billing_account_id

string

The ID of the billing account this subscription belongs to.

Example:

"cus_a1b2c3d4e5f6g7h8"

data.status

enum<string>

The status of the subscription.

Available options:

active,

past_due,

unpaid,

canceled,

incomplete,

incomplete_expired,

trialing,

paused

Example:

"active"

data.currency

enum<string>

The three-letter ISO currency code for the subscription.

Available options:

usd,

zar,

eur,

gbp,

aud

Example:

"usd"

data.product_quantities

object

A map of meterable product types to their subscribed quantities and pricing details.

Show child attributes

data.product_quantities.{key}

object

Show child attributes

data.product_quantities.{key}.price_id

string

The ID of the Stripe Price object.

Example:

"price_1Kb..."

data.product_quantities.{key}.quantity

integer

The number of units subscribed to.

Example:

50

data.product_quantities.{key}.interval

enum<string> | null

The billing interval for this product.

Available options:

day,

week,

month,

year

Example:

"month"

Example:

{
  "locations": {
    "price_id": "price_123abc",
    "quantity": 10,
    "interval": "month"
  },
  "users": {
    "price_id": "price_456def",
    "quantity": 50,
    "interval": "month"
  }
}

data.metadata

object

A set of key-value pairs that you can attach to an object.

Show child attributes

data.metadata.{key}

string

Example:

{ "order_id": "6735" }

data.current_period_start

string<date-time> | null

The start of the current billing period.

Example:

"2025-10-15T00:00:00Z"

data.current_period_end

string<date-time> | null

The end of the current billing period.

Example:

"2025-11-15T00:00:00Z"

data.created_at

string<date-time> | null

The timestamp when the subscription was created.

Example:

"2025-10-15T12:30:00Z"

data.updated_at

string<date-time> | null

The timestamp when the subscription was last updated in our system.

Example:

"2025-10-20T09:00:00Z"

has_more

boolean

Example:

false

Update a billing account

Create a subscription

⌘I

Getting Started

Platform & Identity

Device Management & Orchestration

Automation & AI

Network Services & Connectivity

Security & Threat Management

Monitoring & Analytics

Core Services & Utilities

List subscriptions

Authorizations

Path Parameters

Response