List subscriptions

Use this method to return a paginated list of subscriptions.

Note: If you want to view a specific subscription and you have its subscriptionId, use our Retrieve subscription method.

Use query parameters to filter the list of results that we return, for example, to search for subscriptions for a customer, a payment plan, or frequency.

Our gateway returns information about the following for each subscription in the list:

  • Payment plan the subscription is linked to.
  • Secure token that represents cardholder’s payment details.
  • Current state of the subscription, including its status, next due date, and invoices.
  • Fees for setup and the cost of the recurring order.
  • Subscription length, end date, and frequency.

For each subscription, we also return the subscriptionId, the paymentPlanId, and the secureTokenId, which you can use to perform follow-actions.

Path parameters

processingTerminalIdstringRequired>=4 characters<=50 characters
Unique identifier that we assigned to the terminal.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Idempotency-KeystringRequired

Unique identifier that you generate for each request. You must use the UUID v4 format for the identifier. For more information about the idempotency key, go to Idempotency.

Query parameters

customerNamestringOptional>=1 character<=50 characters
Filter by the customer's name.
last4stringOptionalformat: "[0-9]{4}"
Filter by the last four digits of the card or account number.
paymentPlanstringOptional>=1 character<=128 characters
Filter by the name of the payment plan.
frequencyenumOptional
Filter by the frequency of subscription payments.
Allowed values:
statusenumOptional
Filter by the current status of the subscription.
Allowed values:
endDatedateOptional

Format: YYYY-MM-DD
Filter subscriptions that end on a specific date.

nextDueDatedateOptional

Format: YYYY-MM-DD
Filter subscriptions by the date that the next payment is collected.

beforestringOptional
Points to the resource identifier that you want to receive your results before. Typically, this is the first resource on the previous page.
afterstringOptional
Points to the resource identifier that you want to receive your results after. Typically, this is the last resource on the previous page.
limitintegerOptional<=100Defaults to 10
States the total amount of results the response is limited to.

Response

Successful request. Returns a paginated list of subscriptions.
limitdouble
Maximum number of results that we return for each page.
countdouble
Number of results that we returned.
hasMoreboolean
Indicates that further results are available.
datalist of objects
Array of subscriptions.

Errors