Subscription Versions
List Subscription Versions
Retrieve a list of all subscription versions
GET
/
subscriptions
/
{id}
/
versions
List Subscription Versions
curl --request GET \
--url https://api.alguna.io/subscriptions/{id}/versions \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.alguna.io/subscriptions/{id}/versions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.alguna.io/subscriptions/{id}/versions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"versions": [
{
"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": "subver_0000000000000002",
"createdAt": "2023-12-01T10:30:00Z",
"organizationId": "00000000-0000-0000-0000-000000000001",
"quoteId": "quo_0000000000000001",
"changeDescription": "Initial subscription version",
"startDate": "2024-01-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"]
}
],
"status": "superseded"
}
]
}
Retrieves a list of all subscription versions.
Path Parameters
string
required
The unique identifier of the subscription to retrieve versions for
Response
{
"versions": [
{
"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": "subver_0000000000000002",
"createdAt": "2023-12-01T10:30:00Z",
"organizationId": "00000000-0000-0000-0000-000000000001",
"quoteId": "quo_0000000000000001",
"changeDescription": "Initial subscription version",
"startDate": "2024-01-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"]
}
],
"status": "superseded"
}
]
}
array
List of subscription version objects
Show Subscription Version Object
Show Subscription Version Object
string
Unique identifier for the subscription version
datetime
When the subscription version was created in ISO 8601 format
uuid
The organization ID that owns this subscription version
string
The quote ID associated with this subscription version
string
Optional description of what changed in this version
datetime
Optional start date for this subscription version in ISO 8601 format
datetime
End date determined by us for this subscription version in ISO 8601 format. If
empty, the subscription version is open-ended
array
string
Current status of the subscription version. Possible values:
draft or
published⌘I
List Subscription Versions
curl --request GET \
--url https://api.alguna.io/subscriptions/{id}/versions \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.alguna.io/subscriptions/{id}/versions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.alguna.io/subscriptions/{id}/versions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"versions": [
{
"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": "subver_0000000000000002",
"createdAt": "2023-12-01T10:30:00Z",
"organizationId": "00000000-0000-0000-0000-000000000001",
"quoteId": "quo_0000000000000001",
"changeDescription": "Initial subscription version",
"startDate": "2024-01-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"]
}
],
"status": "superseded"
}
]
}