Skip to main content
GET
/
subscriptions
/
{id}
/
versions
/
{versionId}
Get Subscription Version
curl --request GET \
  --url https://api.alguna.io/subscriptions/{id}/versions/{versionId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "subver_0000000000000001",
  "createdAt": "2024-01-01T12:00:00Z",
  "organizationId": "00000000-0000-0000-0000-000000000001",
  "quoteId": "quo_0000000000000001",
  "changeDescription": "Added new features to enterprise plan",
  "startDate": "2024-02-01T00:00:00Z",
  "endDate": "2024-12-31T23:59:59Z",
  "priceGroups": [
    {
      "name": "Core Features",
      "description": "Essential platform capabilities",
      "bundleId": "bun_0000000000000001",
      "priceIds": [
        "pri_0000000000000001",
        "pri_0000000000000002",
        "pri_0000000000000003"
      ]
    },
    {
      "name": "Add-ons",
      "description": "Optional additional features",
      "bundleId": "bun_0000000000000002",
      "priceIds": ["pri_0000000000000004", "pri_0000000000000005"]
    }
  ],
  "status": "published"
}

Documentation Index

Fetch the complete documentation index at: https://alguna.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Retrieves the details of an existing subscription version. You need to supply the unique subscription identifier and the version identifier.

​
Path Parameters

​
id
string
required
The unique identifier of the subscription to retrieve
​
versionId
string
required
The unique identifier of the subscription version to retrieve

​
Response

{
  "id": "subver_0000000000000001",
  "createdAt": "2024-01-01T12:00:00Z",
  "organizationId": "00000000-0000-0000-0000-000000000001",
  "quoteId": "quo_0000000000000001",
  "changeDescription": "Added new features to enterprise plan",
  "startDate": "2024-02-01T00:00:00Z",
  "endDate": "2024-12-31T23:59:59Z",
  "priceGroups": [
    {
      "name": "Core Features",
      "description": "Essential platform capabilities",
      "bundleId": "bun_0000000000000001",
      "priceIds": [
        "pri_0000000000000001",
        "pri_0000000000000002",
        "pri_0000000000000003"
      ]
    },
    {
      "name": "Add-ons",
      "description": "Optional additional features",
      "bundleId": "bun_0000000000000002",
      "priceIds": ["pri_0000000000000004", "pri_0000000000000005"]
    }
  ],
  "status": "published"
}
​
id
string
Unique identifier for the subscription version
​
createdAt
datetime
When the subscription version was created in ISO 8601 format
​
organizationId
uuid
The organization ID that owns this subscription version
​
quoteId
string
The quote ID associated with this subscription version
​
changeDescription
string
Optional description of what changed in this version
​
startDate
datetime
Optional start date for this subscription version in ISO 8601 format
​
endDate
datetime
End date determined by us for this subscription version in ISO 8601 format. If empty, the subscription version is open-ended
​
priceGroups
array
Groups of prices included in this subscription version
​
status
string
Current status of the subscription version. Possible values: draft or published