Subscription

Get a subscription

Retrieves a single subscription's details.

get/Subscription/{subId}

Request

  • Base URL: https://api-sandbox.payabli.com/api
  • URL: https://api-sandbox.payabli.com/api/Subscription/{subId}
  • Auth: HTTP bearer

Path parameters

subIdinteger required

The subscription ID.

Response

Success

CreatedAtstring date-time

Timestamp of when record was created, in UTC.

EndDatestring date-time nullable required

The subscription's end date.

EntrypageIdinteger

If applicable, the internal reference ID to the payment page associated with the transaction.

ExternalPaypointIDstring

A custom identifier for the paypoint, if applicable.

FeeAmountnumber double

Fee applied to the subscription.

Frequencystring

The subscription's frequency.

IdSubinteger

The subscription's ID.

LastRunstring date-time nullable required

The last time the subscription was processed.

LastUpdatedstring date-time

Timestamp of when record was last updated, in UTC.

LeftCyclesinteger

The number of cycles the subscription has left.

Methodstring

The subscription's payment method.

NetAmountnumber double

Net amount.

NextDatestring date-time nullable required

The next date the subscription will be processed.

ParentOrgNamestring

The name of the parent organization.

PaypointDbanamestring

The alternate or common name that this business is doing business under, usually referred to as a DBA name.

PaypointEntrynamestring

The entrypoint identifier.

PaypointIdinteger

The paypoint's ID. Note that this is different than the entryname.

PaypointLegalnamestring

Business legal name.

PlanIdinteger

Payment plan ID.

Sourcestring

Custom identifier to indicate the transaction or request source.

StartDatestring date-time nullable required

The subscription start date.

SubStatusinteger

The subscription's status.

  • 0: Paused
  • 1: Active
SubscriptionType'Regular' | 'BalanceDriven'

Subscription type or category. Can't be changed after the subscription is created; if sent to the update endpoint, it's ignored.

  • Regular: A standard recurring subscription that charges a fixed amount each cycle.
  • BalanceDriven: A subscription that charges the payor's outstanding balance at run time instead of a fixed amount. Each scheduled run reads the live balance and charges that amount; a zero balance is skipped, not charged. BalanceDriven subscriptions only accept the firstofmonth, fifteenthofmonth, and endofmonth frequencies, ignore any startDate and endDate you supply (start date is calculated from frequency; the schedule runs until cancelled), and don't store a static totalAmount on the schedule.
TotalAmountnumber double

The subscription amount, including any fees.

TotalCyclesinteger

The total number of cycles the subscription is set to run.

UntilCancelledboolean

When true, the subscription has no explicit end date and will run until canceled.

Changes

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