# Get the current active subscription
curl -X GET "https://api.voxmind.ai/organisations/42/subscriptions?sort=start_date:desc&per_page=1" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json"
resp = requests.get(
"https://api.voxmind.ai/organisations/42/subscriptions",
headers={"Authorization": "Bearer YOUR_API_TOKEN"},
params={"sort": "start_date:desc", "per_page": 1},
)
current_subscription = resp.json()["results"][0]
{
"results": [
{
"id": 3,
"org_id": 42,
"plan_id": 2,
"start_date": "2025-03-01",
"end_date": "2025-03-31",
"created_at": "2025-03-01T00:00:00Z",
"updated_at": "2025-03-01T00:00:00Z"
}
]
}
Billing
List Subscriptions
Retrieve all subscriptions for your organisation, including current plan, billing period dates, and subscription status.
GET
/
organisations
/
{orgId}
/
subscriptions
# Get the current active subscription
curl -X GET "https://api.voxmind.ai/organisations/42/subscriptions?sort=start_date:desc&per_page=1" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json"
resp = requests.get(
"https://api.voxmind.ai/organisations/42/subscriptions",
headers={"Authorization": "Bearer YOUR_API_TOKEN"},
params={"sort": "start_date:desc", "per_page": 1},
)
current_subscription = resp.json()["results"][0]
{
"results": [
{
"id": 3,
"org_id": 42,
"plan_id": 2,
"start_date": "2025-03-01",
"end_date": "2025-03-31",
"created_at": "2025-03-01T00:00:00Z",
"updated_at": "2025-03-01T00:00:00Z"
}
]
}
Overview
Returns a list of subscription records for your organisation. In most cases, your organisation will have one active subscription at a time — the history of past subscriptions is accessible here if you need to audit plan changes or billing periods. Subscriptions are managed via the Voxmind dashboard rather than the API — this endpoint is primarily for reading state, not for changing plans. To upgrade or downgrade your plan, use the self-service billing section at developers.voxmind.ai/billing.Path Parameters
string
required
Your organisation’s unique identifier.
Query Parameters
string
Filter subscriptions. Example:
filter=plan_id=2 to find all subscriptions on the Growth plan.string
Sort order. Example:
sort=start_date:desc for most recent first.integer
default:"100"
Results per page. Maximum 300.
integer
default:"1"
Page number.
# Get the current active subscription
curl -X GET "https://api.voxmind.ai/organisations/42/subscriptions?sort=start_date:desc&per_page=1" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json"
resp = requests.get(
"https://api.voxmind.ai/organisations/42/subscriptions",
headers={"Authorization": "Bearer YOUR_API_TOKEN"},
params={"sort": "start_date:desc", "per_page": 1},
)
current_subscription = resp.json()["results"][0]
{
"results": [
{
"id": 3,
"org_id": 42,
"plan_id": 2,
"start_date": "2025-03-01",
"end_date": "2025-03-31",
"created_at": "2025-03-01T00:00:00Z",
"updated_at": "2025-03-01T00:00:00Z"
}
]
}