Get valid billing dates for a subscription

GET

subscriptions

{id}

billing-dates

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"
  }
}

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

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

Show child attributes

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

Show child attributes

Cancel a subscriptionSchedules a cancellation for a subscription. The `effective` timing can be a keyword (e.g. `immediate`, `end_of_term`) or a specific date. A cancellation reason code is required and a free-text note is optional.

⌘I

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"
  }
}