Skip to main content
GET
/
subscriptions
/
{id}
/
billing-dates
Get valid billing dates for a subscription
curl --request GET \
  --url https://api.alguna.io/subscriptions/{id}/billing-dates \
  --header 'Alguna-Version: <alguna-version>' \
  --header 'Authorization: Bearer <token>'
{
  "valid_on_cycle_dates": [
    "2026-08-01"
  ],
  "contract_end_date": "2027-07-01",
  "current_cycle": {
    "end_date": "2026-08-01",
    "start_date": "2026-07-01"
  },
  "next_billing_date": "2026-08-01",
  "next_renewal_date": "2027-07-01",
  "valid_mid_cycle_range": {
    "end_date": "2026-08-01",
    "start_date": "2026-07-01"
  }
}

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.

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

​
id
string
required

Unique identifier for the subscription

Response

Success

​
valid_on_cycle_dates
string[]
required

Valid dates for on-cycle version starts

Example:
["2026-08-01"]
​
contract_end_date
string | null

Contract end date

Example:

"2027-07-01"

​
current_cycle
object

Current billing cycle date range

​
next_billing_date
string | null

Next billing cycle start date

Example:

"2026-08-01"

​
next_renewal_date
string | null

Next renewal date

Example:

"2027-07-01"

​
valid_mid_cycle_range
object

Valid date range for mid-cycle changes