Get subscription payments
curl --request GET \
--url https://dev.api.withconvexity.com/v1/payments/subscription/{subscriptionId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://dev.api.withconvexity.com/v1/payments/subscription/{subscriptionId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://dev.api.withconvexity.com/v1/payments/subscription/{subscriptionId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"status": true,
"message": "Subscription payments retrieved successfully",
"data": [
{
"id": "pay_01HZX8N2K9",
"purpose": "SUBSCRIPTION",
"status": "SUCCESS",
"amount": 1500000,
"currency": "NGN",
"paymentRef": "sub_charge_9f2a1c",
"subscriptionId": "9c3d5a7e-1b2c-4d5e-8f90-abcdef123456",
"projectId": "66f0a1b2c3d4e5f601234567",
"planId": 3,
"billingCycle": "MONTHLY",
"businessId": "42",
"providerId": "prov_kora",
"reference": "KPY-REF-0099",
"amountUsd": "9.87",
"description": "Pro plan, monthly",
"createdBy": "system",
"createdAt": "2026-06-01T09:15:00.000Z",
"updatedAt": "2026-06-01T09:15:03.000Z"
}
]
}Payments
Get subscription payments
Returns all payments tied to a single subscription (not paginated), newest first.
GET
/
v1
/
payments
/
subscription
/
{subscriptionId}
Get subscription payments
curl --request GET \
--url https://dev.api.withconvexity.com/v1/payments/subscription/{subscriptionId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://dev.api.withconvexity.com/v1/payments/subscription/{subscriptionId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://dev.api.withconvexity.com/v1/payments/subscription/{subscriptionId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"status": true,
"message": "Subscription payments retrieved successfully",
"data": [
{
"id": "pay_01HZX8N2K9",
"purpose": "SUBSCRIPTION",
"status": "SUCCESS",
"amount": 1500000,
"currency": "NGN",
"paymentRef": "sub_charge_9f2a1c",
"subscriptionId": "9c3d5a7e-1b2c-4d5e-8f90-abcdef123456",
"projectId": "66f0a1b2c3d4e5f601234567",
"planId": 3,
"billingCycle": "MONTHLY",
"businessId": "42",
"providerId": "prov_kora",
"reference": "KPY-REF-0099",
"amountUsd": "9.87",
"description": "Pro plan, monthly",
"createdBy": "system",
"createdAt": "2026-06-01T09:15:00.000Z",
"updatedAt": "2026-06-01T09:15:03.000Z"
}
]
}⌘I