Subscriptions

List Subscriptions

List all subscriptions with pagination, filtering, and sorting options.

get/api/v2/subscriptions

Query parameters

statusesSubscriptionStatus[] nullable

Filter by subscription status

Filter by subscription status

latest_invoice_is_paidboolean nullable

Filter subscriptions based on if their latest invoice is paid or partially paid

Filter subscriptions based on if their latest invoice is paid or partially paid

from_datestring date-time nullable

datetime is created_at

datetime is created_at

to_datestring date-time nullable

datetime is created_at

datetime is created_at

current_period_start_from_datestring date-time nullable

Filter subscriptions with current_period_start from this date onwards

Filter subscriptions with current_period_start from this date onwards

current_period_start_to_datestring date-time nullable

Filter subscriptions with current_period_start up to this date

Filter subscriptions with current_period_start up to this date

current_period_end_from_datestring date-time nullable

Filter subscriptions with current_period_end from this date onwards

Filter subscriptions with current_period_end from this date onwards

current_period_end_to_datestring date-time nullable

Filter subscriptions with current_period_end up to this date

Filter subscriptions with current_period_end up to this date

number
OR
string

limit list by min subscription amount inclusive

number
OR
string

limit list by max subscription amount inclusive

organization_consumer_idstring uuid4 nullable

filter subscriptions that belongs to organization consumer

filter subscriptions that belongs to organization consumer

search_termstring nullable

Serach by product name or description.

Serach by product name or description.

product_idsstring[] nullable

Product ids that need to be in the list of subscriptions

Product ids that need to be in the list of subscriptions

currenciesstring nullable

Filter subscriptions by currency codes (OR). E.g. currencies=SAR,USD

Filter subscriptions by currency codes (OR). E.g. currencies=SAR,USD

pageinteger

Page number, defaults to 1.

Page number, defaults to 1.

limitinteger

Size of a page, defaults to 10. Maximum is 100.

Size of a page, defaults to 10. Maximum is 100.

sort_fieldstring nullable

Field to sort by, e.g., 'amount', 'scheduled_on'

Field to sort by, e.g., 'amount', 'scheduled_on'

sort_directionstring nullable

Sorting direction ('asc' or 'desc')

Sorting direction ('asc' or 'desc')

Response

Successful Response

Changes

No recorded changes to this endpoint across all 1 revision of this API.