Subscription Versions
List subscription versions
Returns every version attached to a subscription: drafts, the currently active published version, and any future pending versions.
GET
/
subscriptions
/
{id}
/
versions
List subscription versions
curl --request GET \
--url https://api.alguna.io/subscriptions/{id}/versions \
--header 'Alguna-Version: <alguna-version>' \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.alguna.io/subscriptions/{id}/versions"
headers = {
"Alguna-Version": "<alguna-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'Alguna-Version': '<alguna-version>', 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));{
"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"
}
]
}{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}Authorizations
API key authentication. Pass your API key as a Bearer token.
Headers
Available options:
2026-04-01 Path Parameters
Unique identifier for the subscription
Response
Success
List of subscription versions
Show child attributes
Show child attributes
⌘I
List subscription versions
curl --request GET \
--url https://api.alguna.io/subscriptions/{id}/versions \
--header 'Alguna-Version: <alguna-version>' \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.alguna.io/subscriptions/{id}/versions"
headers = {
"Alguna-Version": "<alguna-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'Alguna-Version': '<alguna-version>', 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));{
"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"
}
]
}{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}