GET
/
v1
/
payments
/
subscription
/
{subscriptionId}
Get subscription payments
curl --request GET \
  --url https://api.withconvexity.com/v1/payments/subscription/{subscriptionId} \
  --header 'Authorization: Bearer <token>'
{
  "status": true,
  "message": "Subscription payments retrieved successfully",
  "data": [
    {
      "id": "c41d7e90-22b8-4a6f-9e0c-1b2a3c4d5e6f",
      "purpose": "SUBSCRIPTION",
      "status": "SUCCESS",
      "amount": 25000,
      "currency": "NGN",
      "paymentRef": "kpy_ref_sub_1a2b3c4d",
      "subscriptionId": "sub_8f3a21c0d4",
      "projectId": "proj_3c1a9f0b",
      "planId": 3,
      "billingCycle": "MONTHLY",
      "businessId": "10427",
      "providerId": "a1b2c3d4-e5f6-4711-8899-0a1b2c3d4e5f",
      "reference": "kpy_ref_sub_1a2b3c4d",
      "amountUsd": "15.871500",
      "description": "Subscription: Growth",
      "createdBy": "system",
      "createdAt": "2026-06-01T08:00:12.001Z",
      "updatedAt": "2026-06-01T08:00:12.640Z"
    },
    {
      "id": "d52e8f01-33c9-4b70-8f1d-2c3b4d5e6f70",
      "purpose": "SUBSCRIPTION",
      "status": "SUCCESS",
      "amount": 25000,
      "currency": "NGN",
      "paymentRef": "kpy_ref_sub_5e6f7a8b",
      "subscriptionId": "sub_8f3a21c0d4",
      "projectId": "proj_3c1a9f0b",
      "planId": 3,
      "billingCycle": "MONTHLY",
      "businessId": "10427",
      "providerId": "a1b2c3d4-e5f6-4711-8899-0a1b2c3d4e5f",
      "reference": "kpy_ref_sub_5e6f7a8b",
      "amountUsd": "15.690200",
      "description": "Subscription: Growth",
      "createdBy": "system",
      "createdAt": "2026-05-01T08:00:09.330Z",
      "updatedAt": "2026-05-01T08:00:09.991Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

OAuth 2.0 access token from Auth-Edge.

Path Parameters

​
subscriptionId
string
required

The subscription id to fetch payments for.

Response

200 - application/json

OK

The response is of type object.