Plans
Get plans
API documentation
Integrations
Analytics
Billable events
Companies
Custom properties
Customers
Customers > Credits
Customers > Payment methods
Integrations
Invoices
Invoicing entities
Organisations
Payments
Price configurations
Quotes
Subscriptions
- GETGet subscriptions
- GETGet subscription
- GETGet subscription phases
- GETGet subscription phase
- POSTCreate subscription update
- POSTCreate subscription updates
- POSTCreate subscription
- PUTUpdate subscription
- POSTActivate subscription
- POSTCancel subscription
- POSTPause subscription
- POSTReactivate subscription
- POSTRefresh seat products
- POSTRefresh subscriptions
- POSTReinstate subscription
- POSTTransition subscription to next phase
Third-party apps
Wallets
Plans
Get plans
Retrieve all existing plans.
GET
/
v1
/
plans
curl --request GET \
--url https://api.hyperline.co/v1/plans \
--header 'Authorization: Bearer <token>'
{
"meta": {
"total": 1,
"taken": 1,
"skipped": 0
},
"data": [
{
"id": "plan_zHmjoDea4ZRmQV",
"name": "Starter",
"description": "Starter pack",
"commitment_interval": {
"period": "years",
"count": 1
},
"contract_start_strategy": "start_date",
"contract_start": "2025-01-01T00:00:00.000Z",
"contract_end_strategy": "duration",
"contract_end": "2025-12-31T23:59:59.999Z",
"contract_duration": {
"period": "years",
"count": 1
},
"renew_automatically": true,
"renew_for": {
"period": "years",
"count": 1
},
"trial_interval": {
"period": "months",
"count": 1
}
}
]
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
Required range:
0 < x < 100
Required range:
x > 0
Response
200 - application/json
List of Plan.
Plan ID.
Plan name.
Plan description.
Strategy used to trigger the start of the subscription contract.
Available options:
start_date
, immediately
, manual
, manual_with_latest
, quote_signature
, checkout
Contract start date, applicable if the start strategy is start_date
.
Strategy used to trigger the end of the subscription contract.
Available options:
duration
, manual
, end_date
Contract end date, applicable if the end strategy is end_date
.
Indicates if the subscription to the plan should automatically renew.
Was this page helpful?
curl --request GET \
--url https://api.hyperline.co/v1/plans \
--header 'Authorization: Bearer <token>'
{
"meta": {
"total": 1,
"taken": 1,
"skipped": 0
},
"data": [
{
"id": "plan_zHmjoDea4ZRmQV",
"name": "Starter",
"description": "Starter pack",
"commitment_interval": {
"period": "years",
"count": 1
},
"contract_start_strategy": "start_date",
"contract_start": "2025-01-01T00:00:00.000Z",
"contract_end_strategy": "duration",
"contract_end": "2025-12-31T23:59:59.999Z",
"contract_duration": {
"period": "years",
"count": 1
},
"renew_automatically": true,
"renew_for": {
"period": "years",
"count": 1
},
"trial_interval": {
"period": "months",
"count": 1
}
}
]
}