Skip to main content

List Plans (v1)

Get all subscription plans.

Method & Path​

GET /v1/admin/plans

Description​

Retrieves all subscription plans available in the platform.

Authentication​

Required: Admin authentication with plans.manage permission.

Response 200 OK​

{
  "plans": [
    {
      "id": "507f1f77bcf86cd799439011",
      "name": "Basic Plan",
      "price": 29.99,
      "billingPeriod": "monthly"
    }
  ],
  "meta": {
    "billingPeriods": ["monthly", "yearly"]
  }
}

Common Errors​

  • 401 Unauthorized: Missing or invalid admin authentication token
  • 403 Forbidden: Insufficient permissions
  • 500 Internal Server Error: Server error