Introduction
Endpoints
- Accounts
- Fees
- Invoices
- Meters
- Plans
- Subscriptions
- Credit grants
- Products
- Orders
- Payments
Plans
List plans
Retrieves a list of plans.
GET
/
plans
Copy
curl --request GET \
--url https://sandbox-api.billingrails.com/v1/plans \
--header 'Authorization: Bearer <token>'
Copy
{
"plans": [
{
"object": "plan",
"id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"status": "active",
"name": "<string>",
"code": "<string>",
"description": "<string>",
"trial_period_days": 123,
"currency": "<string>",
"has_metered_fees": true,
"fees": [
{
"object": "fee",
"id": "fee_IhMUl3rrZ3",
"created_at": "2025-02-14T17:33:40.843Z",
"type": "plan",
"meter_id": "meter_IhMUl3rrZ3",
"plan_id": "plan_IhMUl3rrZ3",
"name": "Basic Plan",
"code": "basic_plan",
"description": "Basic plan for users",
"invoice_name": "Basic Plan",
"model": "standard",
"currency": "NGN",
"bill_timing": "advance",
"interval": {
"unit": "month",
"frequency": 1
},
"billing_cycles": 1,
"amount": 1000,
"package_size": 2,
"unit_label": "user",
"free_units": 0,
"active_subscriptions": 5
}
]
}
]
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Response
200 - application/json
Success
The response is of type object
.
Copy
curl --request GET \
--url https://sandbox-api.billingrails.com/v1/plans \
--header 'Authorization: Bearer <token>'
Copy
{
"plans": [
{
"object": "plan",
"id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"status": "active",
"name": "<string>",
"code": "<string>",
"description": "<string>",
"trial_period_days": 123,
"currency": "<string>",
"has_metered_fees": true,
"fees": [
{
"object": "fee",
"id": "fee_IhMUl3rrZ3",
"created_at": "2025-02-14T17:33:40.843Z",
"type": "plan",
"meter_id": "meter_IhMUl3rrZ3",
"plan_id": "plan_IhMUl3rrZ3",
"name": "Basic Plan",
"code": "basic_plan",
"description": "Basic plan for users",
"invoice_name": "Basic Plan",
"model": "standard",
"currency": "NGN",
"bill_timing": "advance",
"interval": {
"unit": "month",
"frequency": 1
},
"billing_cycles": 1,
"amount": 1000,
"package_size": 2,
"unit_label": "user",
"free_units": 0,
"active_subscriptions": 5
}
]
}
]
}
Assistant
Responses are generated using AI and may contain mistakes.