Skip to main content (Press Enter)
Helcim Logo
Click here if you return to contents

Subscription List

This API call let's you retrieve a list of available subscriptions. The response is an XML of the available subscription information.

Request Fields

Field Name Type Required Description
action String Yes subscriptionSearch
accountId Integer Yes The Helcim Commerce account ID.
apiToken String Yes API token used for authentication and access control.
status String No The status of the subscription. (Accepted values: due, expiring, trial, expired, cancelled)
customerCode String No The customer code
recurringPlanCode String No The recurring plan code
dateStartedFrom String No Format: YYYY-MM-DD
dateStartedTo String No Format: YYYY-MM-DD
dateCreatedFrom String No Format: YYYY-MM-DD
dateCreatedTo String No Format:YYYY-MM-DD

Response Fields

Field Name Type Description
subscriptions - XML structure
subscription - XML structure
recurringPlanCode String The code of the recurring plan
customerCode String The customer code.
dateCreated String The date the subscription was created.
dateStarted String The date the subscription was started.
dateRemoved String The date the subscription was ended.
status String Active/Expired. The status of the subscription.
eft String Are EFT transfers used, Yes/No
nickname String Recurring plan nickname
amountInitial Decimal Amount charged at the start of the recurring plan
amountRecurring Decimal The recurring amount
cyclesBilled Integer The number of cycles that have been billed
cyclesTotal Integer The total number of cycles in the plan

Errors

For all API requests, there are also generic API authentication and user access restriction errors.

Response Code Error Code Message Description
0 - Invalid Status Status sent with request is invalid
0 - No Result No subscriptions were found

Related Articles

View a Recurring Plan
Queue a Recurring Plan for Processing
Add or Edit a Subscription
View a Subscription

Was this article helpful?

Feedback submitted - Thank you!
Click here if you return to the content