GET
/
v1
/
subscriptions
/
plans
List plans
curl --request GET \
  --url https://api.withconvexity.com/v1/subscriptions/plans \
  --header 'Authorization: Bearer <token>'
{
  "status": true,
  "message": "Plans retrieved successfully",
  "data": [
    {
      "id": 1,
      "name": "Starter",
      "description": "Entry tier for small projects",
      "isActive": true,
      "type": "SUBSCRIPTION",
      "productId": 101,
      "priceMonthly": 5000,
      "creditRate": {},
      "planQuotas": [
        {
          "id": "2b1f0a9c-1111-4a22-8c33-aa0011223344",
          "planId": 1,
          "metric": "PROJECTS",
          "limitValue": 3,
          "windowsSeconds": null
        },
        {
          "id": "2b1f0a9c-2222-4a22-8c33-aa0011223344",
          "planId": 1,
          "metric": "API_CALLS",
          "limitValue": 100000,
          "windowsSeconds": 2592000
        }
      ],
      "createdBy": "system",
      "createdAt": "2026-01-15T09:00:00.000Z"
    },
    {
      "id": 2,
      "name": "Pay As You Go",
      "description": "Usage-based credits",
      "isActive": true,
      "type": "USAGE",
      "productId": 102,
      "priceMonthly": 0,
      "creditRate": {
        "API_CALLS": 0.5,
        "TOKEN_MINTS": 2
      },
      "planQuotas": [
        {
          "id": "2b1f0a9c-3333-4a22-8c33-aa0011223344",
          "planId": 2,
          "metric": "TOKEN_MINTS",
          "limitValue": null,
          "windowsSeconds": null
        }
      ],
      "createdBy": "system",
      "createdAt": "2026-02-01T11:30:00.000Z"
    }
  ]
}

Authorizations

Authorization
string
header
required

OAuth 2.0 access token from Auth-Edge.

Response

OK

The response is of type object.