GET
/
v1
/
subscriptions
List my subscriptions
curl --request GET \
  --url https://api.withconvexity.com/v1/subscriptions \
  --header 'Authorization: Bearer <token>'
{
  "status": true,
  "message": "Subscriptions retrieved successfully",
  "data": {
    "items": [
      {
        "id": "9f1d6c2e-3b4a-4d8e-8c1a-2f6b9a0c5d11",
        "projectId": "3c9a7b10-44de-4f0a-9c2e-1a2b3c4d5e6f",
        "businessId": "42",
        "planId": 1,
        "billingCycle": "MONTHLY",
        "status": "ACTIVE",
        "subscriptionType": "EXTERNAL",
        "startDate": "2026-06-01T00:00:00.000Z",
        "endDate": "2026-07-01T00:00:00.000Z",
        "autoRenew": true,
        "creditAmount": null,
        "paymentRef": "pay_ref_7f3a9c",
        "createdBy": "system",
        "createdAt": "2026-06-01T08:15:22.000Z",
        "updatedAt": "2026-06-01T08:15:22.000Z"
      },
      {
        "id": "5a2e8b41-7c9d-4f12-a3b6-9d0e1f2a3b4c",
        "projectId": "7b1c2d3e-55ff-4a0b-8c1d-2e3f4a5b6c7d",
        "businessId": "42",
        "planId": 2,
        "billingCycle": null,
        "status": "ACTIVE",
        "subscriptionType": "EXTERNAL",
        "startDate": "2026-05-20T00:00:00.000Z",
        "endDate": null,
        "autoRenew": false,
        "creditAmount": 1500,
        "paymentRef": "pay_ref_2b8d1e",
        "createdBy": "system",
        "createdAt": "2026-05-20T10:42:00.000Z",
        "updatedAt": "2026-06-10T14:03:11.000Z"
      }
    ],
    "total": 2,
    "page": 1,
    "pageSize": 20
  }
}

Authorizations

Authorization
string
header
required

OAuth 2.0 access token from Auth-Edge.

Query Parameters

page
integer
default:1

1-based page number.

pageSize
integer
default:20

Items per page (max 100).

Response

OK

The response is of type object.