Subscription

June 5, 2026 ยท View on GitHub

The subscription details.

Structure

Subscription

Fields

NameTypeTagsDescriptionGetterSetter
IdStringOptional, Read-onlyThe PayPal-generated ID for the subscription.

Constraints: Minimum Length: 3, Maximum Length: 50
String getId()setId(String id)
PlanIdStringOptionalThe ID of the plan.

Constraints: Minimum Length: 3, Maximum Length: 50
String getPlanId()setPlanId(String planId)
StartTimeStringOptionalThe date and time, in Internet date and time format. Seconds are required while fractional seconds are optional. Note: The regular expression provides guidance but does not reject all invalid dates.

Constraints: Minimum Length: 20, Maximum Length: 64, Pattern: ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])[T,t]([0-1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2})$
String getStartTime()setStartTime(String startTime)
QuantityStringOptionalThe quantity of the product in the subscription.

Constraints: Minimum Length: 1, Maximum Length: 32, Pattern: ^([0-9]+|([0-9]+)?[.][0-9]+)$
String getQuantity()setQuantity(String quantity)
ShippingAmountMoneyOptionalThe currency and amount for a financial transaction, such as a balance or payment due.Money getShippingAmount()setShippingAmount(Money shippingAmount)
SubscriberSubscriberOptionalThe subscriber response information.Subscriber getSubscriber()setSubscriber(Subscriber subscriber)
BillingInfoSubscriptionBillingInformationOptionalThe billing details for the subscription. If the subscription was or is active, these fields are populated.SubscriptionBillingInformation getBillingInfo()setBillingInfo(SubscriptionBillingInformation billingInfo)
CreateTimeStringOptionalThe date and time, in Internet date and time format. Seconds are required while fractional seconds are optional. Note: The regular expression provides guidance but does not reject all invalid dates.

Constraints: Minimum Length: 20, Maximum Length: 64, Pattern: ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])[T,t]([0-1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2})$
String getCreateTime()setCreateTime(String createTime)
UpdateTimeStringOptionalThe date and time, in Internet date and time format. Seconds are required while fractional seconds are optional. Note: The regular expression provides guidance but does not reject all invalid dates.

Constraints: Minimum Length: 20, Maximum Length: 64, Pattern: ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])[T,t]([0-1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2})$
String getUpdateTime()setUpdateTime(String updateTime)
CustomIdStringOptionalThe custom id for the subscription. Can be invoice id.

Constraints: Minimum Length: 1, Maximum Length: 127, Pattern: ^[\x20-\x7E]+
String getCustomId()setCustomId(String customId)
PlanOverriddenBooleanOptional, Read-onlyIndicates whether the subscription has overridden any plan attributes.Boolean getPlanOverridden()setPlanOverridden(Boolean planOverridden)
PlanPlanDetailsOptionalThe plan details.PlanDetails getPlan()setPlan(PlanDetails plan)
LinksList<LinkDescription>Optional, Read-onlyAn array of request-related HATEOAS links.List getLinks()setLinks(List links)

Example (as JSON)

{
  "id": "id4",
  "plan_id": "plan_id6",
  "start_time": "start_time8",
  "quantity": "quantity0",
  "shipping_amount": {
    "currency_code": "currency_code0",
    "value": "value6"
  }
}