# GET /subscriptions — List All Subscriptions
> Product: **Pabbly Subscription Billing** (v1)
> Base URL: `https://payments.pabbly.com/api/v1`
> Auth: Basic via `Authorization` header
> Canonical: `/subscription-billing/subscriptions/list-all-subscriptions`
This API is used to retrieve a list of all the available subscriptions.
**Query parameters:**
| Name | Type | Required | Description |
|------|------|----------|-------------|
| email | string | No | Filter subscriptions by the customer's email address. |
| limit | string | No | Integer, default=50, min=1, max=100 The number of resources to be returned. |
| page | string | No | By default first page will be listed. For navigating through pages, use the page parameter. |
| billing_cycle | string | No | Supported value: onetime,lifetime,specific |
| billing_period | string | No | Supported value: w,m,y |
| product_id | string | No | Uniquely identifies the product. It is the api identifier for the product. |
| plan_id | string | No | Uniquely identifies the plan. It is the api identifier for the plan. |
| status | string | No | Supported value: live,pending,cancelled,expired,dunning, trial, nonrenewing, unpaid, paused etc |
**Response (200)** — Subscriptions data:
```json
{
"status": "success",
"message": "Subscriptions data",
"data": [
{
"plan": {
"plan_type": "flat_fee",
"plan_active": "true",
"currency_code": "USD",
"currency_symbol": "$",
"createdAt": "2026-06-01T09:51:50.494Z",
"updatedAt": "2026-06-01T09:51:50.494Z",
"id": "6a1d56368ad0ee9f6f6d715f",
"product_id": "6a1d1eae745ee3979349f653",
"plan_name": "without-trail",
"plan_code": "without-trail",
"price": 999.98,
"billing_period": "",
"billing_period_num": "",
"billing_cycle": "onetime",
"billing_cycle_num": null,
"trial_period": 0,
"setup_fee": 0,
"plan_description": "This is the test plan description.
![](\"https://s3psb.pabbly.com/product/images/2022/2/Y9fZRFgdHKIR-1643959680-PlandescriptionImage.png\")
From the checkout customizer,
- You can change the bullet type.
- You can change list style.
- You can change text size
- You can change the bullet color.
- Image size should be 400W x 250H, Max Size - 100kb.
"
},
"setup_fee": 0,
"currency_code": "USD",
"currency_symbol": "$",
"payment_method": "6a1e71be04fe00b525c77ebd",
"taxable": true,
"gateway_type": "test",
"payment_terms": "net0",
"gateway_id": "66b9be8f7407ad677292a9f8",
"gateway_name": "Test Gateway",
"custom_fields": [],
"requested_ip": "46.62.142.166",
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/148.0.0.0 Safari/537.36",
"createdAt": "2026-06-02T06:01:34.220Z",
"updatedAt": "2026-06-02T06:01:35.047Z",
"id": "6a1e71be04fe00b525c77eba",
"customer_id": "6a1975b6d8b5977e562a0f03",
"product_id": "6a1d1eae745ee3979349f653",
"plan_id": "6a1d56368ad0ee9f6f6d715f",
"amount": 999.98,
"email_id": "abhishek.pandey@pabbly.com",
"status": "live",
"quantity": 1,
"starts_at": "2026-06-02T06:01:34.343Z",
"activation_date": "2026-06-02T06:01:35.353Z",
"expiry_date": "2126-06-02T06:01:34.343Z",
"trial_days": 0,
"trial_expiry_date": "",
"next_billing_date": "",
"last_billing_date": "2026-06-02T06:01:35.353Z",
"canceled_date": null,
"product": {
"status": "active",
"createdAt": "2026-06-01T05:54:54.049Z",
"updatedAt": "2026-06-01T05:54:54.049Z",
"id": "6a1d1eae745ee3979349f653",
"product_name": "trial",
"notification_email": null,
"redirect_url": null,
"hostedPage": null
}
},
{
"plan": {
"plan_type": "flat_fee",
"plan_active": "true",
"currency_code": "USD",
"currency_symbol": "$",
"createdAt": "2026-06-01T09:51:50.494Z",
"updatedAt": "2026-06-01T09:51:50.494Z",
"id": "6a1d56368ad0ee9f6f6d715f",
"product_id": "6a1d1eae745ee3979349f653",
"plan_name": "without-trail",
"plan_code": "without-trail",
"price": 999.98,
"billing_period": "",
"billing_period_num": "",
"billing_cycle": "onetime",
"billing_cycle_num": null,
"trial_period": 0,
"setup_fee": 0,
"plan_description": "This is the test plan description.
From the checkout customizer,
- You can change the bullet type.
- You can change list style.
- You can change text size
- You can change the bullet color.
- Image size should be 400W x 250H, Max Size - 100kb.
"
},
"setup_fee": 0,
"currency_code": "USD",
"currency_symbol": "$",
"coupon": {
"status": "active",
"apply_to": "total_amount",
"createdAt": "2026-06-01T09:52:21.430Z",
"updatedAt": "2026-06-01T09:52:21.430Z",
"id": "6a1d56557bc4bf9f584cca5c",
"product_id": "6a1d1eae745ee3979349f653",
"coupon_name": "without-trail",
"coupon_code": "without-trail",
"discount": 10,
"discount_type": "percent",
"redemption_type": "forever",
"redemption_cycle": 0,
"associate_plans": "all_plans",
"plans_array": null,
"valid_upto": "2026-06-25",
"maximum_redemption": 500,
"used_redemption": 0
},
"payment_method": "6a1d566d7bc4bf9f584cca68",
"taxable": true,
"gateway_type": "test",
"payment_terms": "net0",
"gateway_id": "66b9be8f7407ad677292a9f8",
"gateway_name": "Test Gateway",
"custom_fields": [],
"requested_ip": "46.62.142.166",
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/148.0.0.0 Safari/537.36",
"createdAt": "2026-06-01T09:52:44.582Z",
"updatedAt": "2026-06-01T09:52:45.393Z",
"id": "6a1d566c7bc4bf9f584cca66",
"customer_id": "6a1975b6d8b5977e562a0f03",
"product_id": "6a1d1eae745ee3979349f653",
"plan_id": "6a1d56368ad0ee9f6f6d715f",
"amount": 999.98,
"email_id": "abhishek.pandey@pabbly.com",
"status": "live",
"quantity": 1,
"starts_at": "2026-06-01T09:52:44.444Z",
"activation_date": "2026-06-01T09:52:45.454Z",
"expiry_date": "2126-06-01T09:52:44.444Z",
"trial_days": 0,
"trial_expiry_date": "",
"next_billing_date": "",
"last_billing_date": "2026-06-01T09:52:45.454Z",
"canceled_date": null,
"product": {
"status": "active",
"createdAt": "2026-06-01T05:54:54.049Z",
"updatedAt": "2026-06-01T05:54:54.049Z",
"id": "6a1d1eae745ee3979349f653",
"product_name": "trial",
"notification_email": null,
"redirect_url": null,
"hostedPage": null
}
},
{
"plan": {
"plan_type": "flat_fee",
"plan_active": "true",
"currency_code": "USD",
"currency_symbol": "$",
"trial_type": "day",
"createdAt": "2026-06-01T05:56:46.377Z",
"updatedAt": "2026-06-01T05:56:46.377Z",
"id": "6a1d1f1e8ad0ee9f6f6d5c00",
"product_id": "6a1d1eae745ee3979349f653",
"plan_name": "Paid Trial Plan",
"plan_code": "paid-trial-plan",
"price": 999.99,
"billing_period": "",
"billing_period_num": "",
"billing_cycle": "onetime",
"billing_cycle_num": null,
"trial_period": 10,
"setup_fee": 0,
"plan_description": "This is the test plan description.
From the checkout customizer,
- You can change the bullet type.
- You can change list style.
- You can change text size
- You can change the bullet color.
- Image size should be 400W x 250H, Max Size - 100kb.
"
},
"setup_fee": 0,
"currency_code": "USD",
"currency_symbol": "$",
"coupon": {
"status": "active",
"apply_to": "total_amount",
"createdAt": "2026-06-01T05:59:07.221Z",
"updatedAt": "2026-06-01T05:59:07.221Z",
"id": "6a1d1fab8ad0ee9f6f6d5c44",
"product_id": "6a1d1eae745ee3979349f653",
"coupon_name": "gegegeg",
"coupon_code": "gegegegr",
"discount": 48,
"discount_type": "flat",
"redemption_type": "onetime",
"redemption_cycle": 0,
"associate_plans": "all_plans",
"plans_array": null,
"valid_upto": "2026-06-18",
"maximum_redemption": 100,
"used_redemption": 0
},
"payment_method": "6a1d1fc98ad0ee9f6f6d5c4e",
"taxable": true,
"gateway_type": "test",
"payment_terms": "net0",
"gateway_id": "66b9be8f7407ad677292a9f8",
"gateway_name": "Test Gateway",
"custom_fields": [],
"requested_ip": "103.82.99.55",
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/148.0.0.0 Safari/537.36",
"createdAt": "2026-06-01T05:59:36.887Z",
"updatedAt": "2026-06-01T05:59:37.896Z",
"id": "6a1d1fc88ad0ee9f6f6d5c4b",
"customer_id": "6a1975b6d8b5977e562a0f03",
"product_id": "6a1d1eae745ee3979349f653",
"plan_id": "6a1d1f1e8ad0ee9f6f6d5c00",
"amount": 999.99,
"email_id": "abhishek.pandey@pabbly.com",
"status": "trial",
"quantity": 1,
"starts_at": "2026-06-01T05:59:36.363Z",
"activation_date": "2026-06-11T05:59:36.363Z",
"expiry_date": "2126-06-11T05:59:36.363Z",
"trial_days": 10,
"trial_expiry_date": "2026-06-11T05:59:36.363Z",
"next_billing_date": "",
"last_billing_date": "",
"canceled_date": null,
"product": {
"status": "active",
"createdAt": "2026-06-01T05:54:54.049Z",
"updatedAt": "2026-06-01T05:54:54.049Z",
"id": "6a1d1eae745ee3979349f653",
"product_name": "trial",
"notification_email": null,
"redirect_url": null,
"hostedPage": null
}
},
{
"plan": {
"plan_type": "flat_fee",
"plan_active": "true",
"currency_code": "EUR",
"currency_symbol": "€",
"createdAt": "2026-05-25T12:02:32.794Z",
"updatedAt": "2026-05-25T12:02:32.794Z",
"id": "6a143a5889f06ff9ee2d5e1e",
"product_id": "69e1d96ce9535f035209a70c",
"plan_name": "euro-testing",
"plan_code": "euro-testing",
"price": 1000.01,
"billing_period": "",
"billing_period_num": "",
"billing_cycle": "onetime",
"billing_cycle_num": null,
"trial_period": 0,
"setup_fee": 0,
"plan_description": "This is the test plan description.
From the checkout customizer,
- You can change the bullet type.
- You can change list style.
- You can change text size
- You can change the bullet color.
- Image size should be 400W x 250H, Max Size - 100kb.
"
},
"setup_fee": 0,
"currency_code": "EUR",
"currency_symbol": "€",
"payment_method": "6a1975b7d8b5977e562a0f07",
"taxable": true,
"gateway_type": "test",
"payment_terms": "net0",
"gateway_id": "66b9be8f7407ad677292a9f8",
"gateway_name": "Test Gateway",
"custom_fields": [
{
"name": "cf_key_d7dtr9",
"type": "text",
"label": "key",
"value": ""
},
{
"name": "cf_key_8truw2",
"type": "text",
"label": "key",
"value": ""
}
],
"requested_ip": "46.62.142.166",
"createdAt": "2026-05-29T11:17:10.870Z",
"updatedAt": "2026-05-29T11:17:11.735Z",
"id": "6a1975b6d8b5977e562a0f05",
"customer_id": "6a1975b6d8b5977e562a0f03",
"product_id": "69e1d96ce9535f035209a70c",
"plan_id": "6a143a5889f06ff9ee2d5e1e",
"amount": 1000.01,
"email_id": "abhishek.pandey@pabbly.com",
"status": "live",
"quantity": 1,
"starts_at": "2026-05-29T11:17:10.101Z",
"activation_date": "2026-05-29T11:17:11.111Z",
"expiry_date": "2126-05-29T11:17:10.101Z",
"trial_days": 0,
"trial_expiry_date": "",
"next_billing_date": "",
"last_billing_date": "2026-05-29T11:17:11.111Z",
"canceled_date": null,
"product": {
"status": "active",
"createdAt": "2026-04-17T06:55:40.011Z",
"updatedAt": "2026-04-17T06:55:40.011Z",
"id": "69e1d96ce9535f035209a70c",
"product_name": "error",
"notification_email": null,
"redirect_url": null,
"hostedPage": null
}
}
]
}
```
**Code examples:**
_cURL_
```curl
curl https://payments.pabbly.com/api/v1/subscriptions?email={{email}}&limit={{limit}}&page={{page}}&billing_cycle={{billing_cycle}}&billing_period={{billing_period}}&product_id={{product_id}}&plan_id={{plan_id}}&status={{status}} \
-u {{YOUR_API_KEY}}:{{YOUR_SECRET_KEY}}
```
_Ruby_
```ruby
require 'net/http'
require 'json'
uri = URI('https://payments.pabbly.com/api/v1/subscriptions?email={{email}}&limit={{limit}}&page={{page}}&billing_cycle={{billing_cycle}}&billing_period={{billing_period}}&product_id={{product_id}}&plan_id={{plan_id}}&status={{status}}')
request = Net::HTTP::Get.new(uri)
request.basic_auth '{{YOUR_API_KEY}}', '{{YOUR_SECRET_KEY}}'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
data = JSON.parse(response.body)
```
_Python_
```python
import requests
from requests.auth import HTTPBasicAuth
response = requests.get(
'https://payments.pabbly.com/api/v1/subscriptions?email={{email}}&limit={{limit}}&page={{page}}&billing_cycle={{billing_cycle}}&billing_period={{billing_period}}&product_id={{product_id}}&plan_id={{plan_id}}&status={{status}}',
auth=HTTPBasicAuth('{{YOUR_API_KEY}}', '{{YOUR_SECRET_KEY}}'),
)
data = response.json()
```
_PHP_
```php
response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```
_Node.js_
```node
const credentials = Buffer.from('{{YOUR_API_KEY}}:{{YOUR_SECRET_KEY}}').toString('base64');
const response = await fetch('https://payments.pabbly.com/api/v1/subscriptions?email={{email}}&limit={{limit}}&page={{page}}&billing_cycle={{billing_cycle}}&billing_period={{billing_period}}&product_id={{product_id}}&plan_id={{plan_id}}&status={{status}}', {
method: 'GET',
headers: {
'Authorization': `Basic ${credentials}`,
},
});
const data = await response.json();
```
_Go_
```go
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://payments.pabbly.com/api/v1/subscriptions?email={{email}}&limit={{limit}}&page={{page}}&billing_cycle={{billing_cycle}}&billing_period={{billing_period}}&product_id={{product_id}}&plan_id={{plan_id}}&status={{status}}", nil)
req.SetBasicAuth("{{YOUR_API_KEY}}", "{{YOUR_SECRET_KEY}}")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
```
_.NET_
```dotnet
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;
var credentials = Convert.ToBase64String(Encoding.ASCII.GetBytes("{{YOUR_API_KEY}}:{{YOUR_SECRET_KEY}}"));
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://payments.pabbly.com/api/v1/subscriptions?email={{email}}&limit={{limit}}&page={{page}}&billing_cycle={{billing_cycle}}&billing_period={{billing_period}}&product_id={{product_id}}&plan_id={{plan_id}}&status={{status}}");
request.Headers.TryAddWithoutValidation("Authorization", $"Basic {credentials}");
var response = await client.SendAsync(request);
var data = await response.Content.ReadAsStringAsync();
Console.WriteLine(data);
```
---
**Other endpoints in Subscriptions:**
- [POST /subscription/{{customer_id}} — Create Subscription For Existing Customer](/subscription-billing/subscriptions/create-subscription-for-existing-customer)
- [POST /subscription/{{subscription_id}}/cancel — Cancel Subscription For Existing Customer](/subscription-billing/subscriptions/cancel-subscription-for-existing-customer)
- [GET /subscription/{{subscription_id}} — Get Single Subscription](/subscription-billing/subscriptions/get-single-subscription)
- [GET /subscriptions/{{customer_id}} — List All Subscriptions By Customer Id](/subscription-billing/subscriptions/list-all-subscriptions-by-customer-id)
- [GET /scheduledchanges/{{suscription_id}} — Get Scheduled Subscription](/subscription-billing/subscriptions/get-scheduled-subscription)
- [PUT /subscription/{{subscription_id}}/upgrade-downgrade — Upgrade Downgrade Subscription](/subscription-billing/subscriptions/upgrade-downgrade-subscription)
- [POST /subscription/{{subscription_id}}/update_charges — Subscription Update Charges](/subscription-billing/subscriptions/subscription-update-charges)
- [DELETE /subscriptions/{{subscription_id}} — Delete Subscription](/subscription-billing/subscriptions/delete-subscription)
- [PUT /subscription/change-billing/{{subscription_id}} — Change Subscription Billing Date](/subscription-billing/subscriptions/change-subscription-billing-date)
- [PUT /subscription/{{subscription_id}}/update — Update Subscription](/subscription-billing/subscriptions/update-subscription)
- [PUT /subscription/{{subscription_id}}/pause — Pause Subscription](/subscription-billing/subscriptions/pause-subscription)
- [PUT /subscription/{{subscription_id}}/resume — Resume Subscription](/subscription-billing/subscriptions/resume-subscription)