List subscription versions

GET

subscriptions

{id}

versions

curl --request GET \
  --url https://api.alguna.io/subscriptions/{id}/versions \
  --header 'Alguna-Version: <alguna-version>' \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "created_at": "2025-12-15T10:30:00Z",
      "id": "subv_abc123",
      "status": "published",
      "subscription_id": "sub_abc123",
      "updated_at": "2026-01-01T00:00:00Z",
      "description": "Annual step-up",
      "end_date": "2027-01-01T00:00:00Z",
      "plan_id": "pln_abc123",
      "start_date": "2026-01-01T00:00:00Z"
    }
  ]
}

Authorizations

Authorization

string

header

required

API key authentication. Pass your API key as a Bearer token.

Headers

Alguna-Version

enum<string>

required

Available options:

2026-04-01

Path Parameters

string

required

Unique identifier for the subscription

Response

Success

data

object[]

required

List of subscription versions

Show child attributes

Create a new subscription versionCreates a new version from a complete item set. Returns a draft by default that can be edited and published later. This is the snapshot-based mutation path (Path B) for full control over the version contents. For the delta-based alternative, use `create-subscription-change`. See the [Updating a Subscription](/docs/api-reference/v2/examples/updating-a-subscription) examples.

⌘I

List subscription versions

curl --request GET \
  --url https://api.alguna.io/subscriptions/{id}/versions \
  --header 'Alguna-Version: <alguna-version>' \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "created_at": "2025-12-15T10:30:00Z",
      "id": "subv_abc123",
      "status": "published",
      "subscription_id": "sub_abc123",
      "updated_at": "2026-01-01T00:00:00Z",
      "description": "Annual step-up",
      "end_date": "2027-01-01T00:00:00Z",
      "plan_id": "pln_abc123",
      "start_date": "2026-01-01T00:00:00Z"
    }
  ]
}