Skip to main content

Supported response attributes

Response FieldFormatDescription
idStringThe unique identifier assigned to the subscription by the channel. This is the identifier that should be used in subsequent subscription API calls.
creationDateStringThe date on which the subscripton was created.
endDateStringThe end date for the subscription (e.g., in the case of a contract); may be NULL.
externalAccountIdStringThe identifier for the external (to the channel) account.
statusString EnumThe status of the subscription order; can be INITIALIZED, PENDING_USER_APPROVAL, PENDING_REMOTE_CREATION, FREE_TRIAL, ACTIVE, FINISHED, ONE_TIME, CANCELLED, SUSPENDED, FREE_TRIAL_EXPIRED, FREE_TRIAL_CANCELLED, DELETED, FAILED, UPCOMING, PENDING_MIGRATION_ACTIVATION.
maxUsersNumericThe maximum number of users allowed for the subscription.
orderObjectThe order information for the subscription that was created.
order.paymentPlanIdStringThe unique identifier for the edition pricing for which a subscription is being created.
order.discountIdStringThe unique identifier for the discount to be applied to the subscription.
order.activatedbooleanTrue if the subscription has been activated.
order.paymentPlanObjectAn object representing the payment plan for this subscription.
paymentPlan.idStringThe identifier for the payment plan created by the channel.
paymentPlan.hrefStringThe link to the payment plan.
paymentPlan.uuidStringThe unique identifier for the payment plan.
paymentPlan.frequencyStringThe frequency of billing; may be ONE_TIME, MONTHLY, QUARTERLY, SIX_MONTHS, YEARLY, TWO_YEARS, THREE_YEARS, or DAILY.
paymentPlan.contractObjectAn object containing contract information for the payment plan.
contract.minimumServiceLengthNumericThe minimum service length specified by the contract.
contract.cancellationPeriodLimitNumericThe cancellation period limit specified by the contract.
contract.endOfContractGracePeriodNumericThe grace period allowed at the end of the contract.
contract.blockSwitchToShorterContractBooleanTrue if the contract blocks changing to a shorter contract.
contract.blockContractDowngradesBooleanTrue if the contract blocks contract downgrades.
contract.blockContractUpgradesBooleanTrue if the contract blocks contract upgrades.
contract.autoExtensionPricingIdNumericThe identifier for the pricing plan for the contract autoextension, if applicable.
contract.gracePeriodObjectAn object representing the contract grace period.
gracePeriod.lengthNumericThe length of the grace period specified by the contract.
gracePeriod.unitStringThe units for the grace period length specified by the contract.
contract.terminationFeeObjectAn object representing the contract termination fee.
terminationFee.typeString EnumThe termination fee type; can be NONE, PERCENTAGE, or FLAT_RATE.
terminationFee.descriptionStringThe termination fee description.
terminationFee.percentageFeeNumericThe percentage to charge for the termination fee.
terminationFee.flatFeeObjectAn object representing the flat fee to charge for the termination fee; this will contain an entry for each supported currency for the product.
paymentPlan.allowCustomUsageBooleanTrue if custom usage is allowed for the subscription.
paymentPlan.keepBillDateOnUsageChangeBooleanTrue if the billling date doesn't change on usage changes to the subscription.
paymentPlan.separatePrepaidBooleanTrue if prepayment is separate.
paymentPlan.isPrimaryPriceBooleanTrue if this is the primary price for the subscription.
paymentPlan.costsArrayAn array of objects containing cost information.
costs.costObjectAn object containing cost information.
cost.amountObjectAn object representing the cost amount; this will contain an entry for each supported currency for the product.
cost.pricePerIncrementBooleanTrue if the price applies per increment.
cost.blockContractDecreaseBooleanTrue if the contract blocks a contract decrease in cost.
cost.blockContractIncreaseBooleanTrue if the contract blocks a contract increase in cost.
cost.blockOriginalContractDecreaseBooleanTrue if the contract blocks a decrease in cost from the original contract.
cost.unitString EnumThe unit for the contract cost. See orderLine.unit for valid units.
cost.unitDependencyStringThe unit dependency for the contract cost.
cost.minUnitsNumericThe minimum units allowed.
cost.maxUnitsNumericThe maximum units allowed.
cost.meteredUsageBooleanTrue if the cost is for metered usage.
cost.incrementNumericmThe increment the cost applies to.
paymentPlan.discountObjectAn object containing the discount information.
discount.amountObjectAn object representing the discount amount; this will contain an entry for each supported currency for the product.
discount.descriptionStringThe discount description.
discount.percentageNumericThe percentage discount.
discount.numOfBillingCyclesNumericThe number of billing cycles the discount applies to.
discount.availableRedemptionsNumericThe number of times remaining the discount can be applied.
discount.startDateStringThe start date of the discount.
discount.expirationDateStringThe expiration date of the discount.
order.contractObjectAn object representing the contract for this subscription, if applicable.
contract.minimumServiceLengthNumericThe minimum service length specified by the contract.
contract.cancellationPeriodLimitNumericThe cancellation period limit specified by the contract.
contract.endOfContractGracePeriodNumericThe grace period allowed at the end of the contract.
contract.endOfContractDateStringThe end date of the contract.
contract.gracePeriodEndDateStringThe end date of the contract grace period.
contract.terminationFeeObjectAn object representing the contract termination fee.
terminationFee.typeString EnumThe termination fee type; can be NONE, PERCENTAGE, or FLAT_RATE.
terminationFee.descriptionStringThe termination fee description.
terminationFee.percentageNumericThe percentage to charge for the termination fee.
terminationFee.priceObjectAn object representing the flat fee price to charge for the termination fee; this will contain an entry for each supported currency for the product.
contract.renewalObjectAn object representing the contract renewal.
renewal.orderStringA link to the contract renewal rder.
renewal.paymentPlanStringTA link to the contract renewal payment plan.
order.previousOrderStringA link to the previous order.
order.nextOrderStringA link to the next order.
order.discountStringA link to the discount.
order.orderLinesArrayAn array of orderLine objects representing the subscription information. This information is required in cases where additional information is required by the edition. An example of this would be an edition that has individual unit pricing ("price per unit"), so information about the desired number of units must be passed.
orderLines.orderLineObjectAn object containing information about one line of the subscription order.
orderLine.typeString EnumThe type of order line item; can be ITEM, TAX, PENALTY, or DISCOUNT.
orderLine.unitString EnumThe unit type of order line item; can be USER, GIGABYTE, MEGABYTE, HOUR, MINUTE, INVOICE, UNIT, PROJECT, PROPERTY, ITEM, WORD, EMAIL, CONTACT, CALL, CREDIT, ROOM, HOST, AGENT, OPERATOR, PROVIDER, MANAGER, TESTER, JVM, SERVER, WEB_USE_MINUTE, AUDIO_USE_MINUTE, PIECE, EMPLOYEE_PAY_PERIOD, COMPUTER, NOT_APPLICABLE, ONE_TIME_SETUP, DATA_POINTS, TIER1_API_CALLS, TIER2_API_CALLS, ADVISORY_HOURS, OVERAGE_AUDIO_MINUTE, EMPLOYEE, CONNECTION, PUSH_USER, THOUSAND_EMAILS_PER_DAY, PUSH_NOTIFICATION_DEVICES, API_CALLS, SMS_TEXT_MESSAGE, CONTACTS_1000, CONTRACT_FEE, TRANSFER_FEE, REACTIVATION_FEE, RECIPIENT, ADDITIONAL_1000_CONTACTS_BLOCK, SCHEDULE_PLAN, EMAILS_1000, MOBILE_DEVICE, PAYSLIP, PAYSLIP_CORRECTION, STORE, WEBSITE, EPAPER, PAGE, POSTAGE_AND_PRINT, INTERNATIONAL_POSTAGE_AND_PRINT, TIER1_TOP_LEVEL_DOMAIN, TIER2_TOP_LEVEL_DOMAIN, DEDICATED_IP, ENABLELCM, MAXCOMPONENTS, DATA_MANAGEMENT_USER, SPECIALIST_USER, PROFESSIONAL_USER, MATERIALITY_MATRIX, STAKEHOLDER_MANAGEMENT, SCORECARD, STANDARD_MAPPING, DONATION_MANAGEMENT, DOCUMENT, PACKAGE_SMALL, PACKAGE_LARGE, MEMBER, ATTENDEE, MAILING, RESPONSE, EXTERNAL_INVOICE_FEE, CLIENT_TEST, IMAGE_TRANSFORMATION, TOTAL_IMAGE, LICENSE, MAILBOX, FREE_40_INCH_HDTV_PC, FREE_46_INCH_HDTV_PC, FREE_46_INCH_HDTV_PC_MOUNTING, EMPLOYEE_PER_WEEK, REGISTER, END_USER, CORE, DEVICE, PORT, MEASURER, PUBLISHED_MEASUREMENT, NODE, SERVER_RULE, VPN_LP, PROXY_LP, DESKTOP_CONNECT_LP, CAMERA, MAIN_SOUND_ZONE, SUB_SOUND_ZONE, POST, REPORT, BOX, SESSION, DISPLAY, TRUCKROLL, TRANSACTION_FEE, SENDING_API_CALL, LOOKUP_API_CALL, or ANALYTICS_API_CALL.
orderLine.quantityNumericThe quantity for order line item.
orderLine.priceNumericThe price per unit for order line item.
orderLine.percentageNumericThe percentage (e.g., tax) associated with order line item.
orderLine.totalPriceNumericThe total price for order line item.
orderLine.descriptionStringThe description of order line item.
order.oneTimeOrdersArrayAn array of any one time order listings.
oneTimeOrders.oneTimeOrderObjectAn object representing a one time order.
oneTimeOrder.paymentPlanStringA link to the payment plan for the one time order.
oneTimeOrder.idStringThe one time order provided by the channel.
oneTimeOrder.startDateStringThe one time order start date.
oneTimeOrder.endDateStringThe one time order end date.
oneTimeOrder.nextBillingDateStringThe next billing date for the one time order.
oneTimeOrder.endOfDiscountDateStringThe end date for the one time order discount, if applicable.
oneTimeOrder.statusString EnumThe status of the subscription order; can be INITIALIZED, PENDING_USER_APPROVAL, PENDING_REMOTE_CREATION, FREE_TRIAL, ACTIVE, FINISHED, ONE_TIME, CANCELLED, SUSPENDED, FREE_TRIAL_EXPIRED, FREE_TRIAL_CANCELLED, DELETED, FAILED, UPCOMING, PENDING_MIGRATION_ACTIVATION.
oneTimeOrder.frequencyStringThe frequency of billing, in this case ONE_TIME.
oneTimeOrder.currencyStringThe currency for the one time order; may be USD, CAD, EUR, JPY, GBP, KRW, CHF, SEK, SGD, MYR, AUD, MXN, INR, BRL, DKK, NZD, NOK, ZAR, PHP
oneTimeOrder.typeStringThe subscription type for the one time order; may be NEW, MIGRATION, ADOPTION, METERED_USAGE, FREE_TRIAL_ACTIVATION, BUNDLED, TERMINATION_FEE, END_OF_CONTRACT_MIGRATION, REFUND, CREDIT, ONE_TIME_FEE, ADDITIONAL_FEE.
oneTimeOrder.totalPriceNumericThe total price of the one time order.
oneTimeOrder.userStringA link to the user to which the one time order is associated.
oneTimeOrder.salesSupportUserStringA link to the sales support user to which the one time order is associated.
oneTimeOrder.companyStringA link to the company to which the one time order is associated.
order.parametersArrayAn array of optional parameters required in order to create a subscription to a product. Some products will require additional information that can be passed through this attribute.
parameters.nameStringThe name of the parameter to be passed.
parameters.valueStringThe value of the parameter to be passed.

Was this page helpful?