List subscriptions
Lists the subscriptions of your organization for the live or test mode of the API key used, with their subscription items included. The list is paginated with cursors: use the Link response header or the starting_after and ending_before query parameters to navigate between pages.
v2 · Base URL https://api.fintoc.com/v2Authorizations
Query Parameters
A cursor to use in pagination. ending_before is a subscription ID that defines your place in the list. For example, if you make a list request and receive 30 subscriptions, starting with sub_bar, your subsequent call can include ending_before=sub_bar to fetch the previous page of the list.
Maximum number of subscriptions to return per page. Ranges from 1 to 300. Defaults to 30.
30
A cursor to use in pagination. starting_after is a subscription ID that defines your place in the list. For example, if you make a list request and receive 30 subscriptions, ending with sub_foo, your subsequent call can include starting_after=sub_foo to fetch the next page of the list.
Response
List of subscriptions for the current mode, with their items included.
Unique identifier of the subscription.
"sub_2c4mDcMaVxDx7nT3o5GbPMQbS2v"
Type of the object. Always subscription.
ISO 8601 timestamp that anchors the billing cycle. Fintoc sets this anchor to the subscription's creation time, or to trial_end when a trial applies. Fintoc measures every billing period from this anchor.
"2026-06-01T15:00:00Z"
Method Fintoc uses to collect the invoices the subscription generates. One of charge_automatically (Fintoc charges the saved payment method) or send_invoice (Fintoc sends the invoice for the customer to pay). Subscriptions created through the API always use send_invoice.
charge_automatically, send_invoice "send_invoice"
ISO 8601 timestamp of when the subscription was created.
"2026-06-01T15:00:00Z"
ID of the customer the subscription bills.
"cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu"
Items the subscription bills for on every billing cycle.
Set of key-value pairs attached to the subscription.
Mode of the object. One of live or test. test subscriptions use fake data for integration testing and do not collect real money.
live, test "live"
ID of the payment method charged when collection_method is charge_automatically. Always null for subscriptions created through the API.
null
Current status of the subscription. One of active, incomplete (the first invoice payment has not yet succeeded), trialing (the trial period has not ended), or canceled (the subscription stopped generating invoices).
active, canceled, incomplete, trialing "active"
ISO 8601 timestamp at which the trial period ends, or null if the subscription has no trial.
null