Get all subscription previews
get
/crmRestApi/resources/11.13.18.05/previewSubscriptions
Request
Query Parameters
-
expand: string
When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "". More than one child can be specified using comma as a separator. Example: ?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers).
-
fields: string
This parameter filters the resource fields. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links). If an indirect child resource is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?fields=Employees.Managers:Empname" is the same as "?fields=;Employees:;Employees.Managers:Empname" (which will only return the "Empname" field for Managers). the value of this query parameter is a list of resource fields. The attribute can be a direct (Example: Employees) or indirect (Example: Employees.Managers) child. It cannot be combined with expand query parameter. If both are provided, only fields will be considered.
Format: ?fields=Attribute1,Attribute2
Format for fields in child resource: ?fields=Accessor1:Attribute1,Attribute2 -
finder: string
Used as a predefined finder to search the collection.
Format ?finder=<finderName>;<variableName>=<variableValue>,<variableName2>=<variableValue2>
The following are the available finder names and corresponding finder variables- PrimaryKey Finds the subscription preview with the specified primary key.
Finder Variables- SubscriptionId; integer; The unique identifier of the subscription used to find the subscription preview.
- PrimaryKey Finds the subscription preview with the specified primary key.
-
limit: integer
This parameter restricts the number of resources returned inside the resource collection. If the limit exceeds the resource count then the framework will only return the available resources.
-
links: string
This parameter can be used to show only certain links while accessing a singular resource or a resource collection. The parameter value format is a comma-separated list of : <link_relation>
Example:
self,canonical -
offset: integer
Used to define the starting position of the resource collection. If offset exceeds the resource count then no resources are returned. Default value is 0.
-
onlyData: boolean
The resource item payload will be filtered in order to contain only data (no links section, for example).
-
orderBy: string
This parameter orders a resource collection based on the specified fields. The parameter value is a comma-separated string of attribute names, each optionally followed by a colon and "asc" or "desc". Specify "asc" for ascending and "desc" for descending. The default value is "asc". For example, ?orderBy=field1:asc,field2:desc
-
q: string
This query parameter defines the where clause. The resource collection will be queried using the provided expressions. The value of this query parameter is one or more expressions. Example: ?q=Deptno>=10 and <= 30;Loc!=NY
Format: ?q=expression1;expression2
You can use these queryable attributes to filter this collection resource using the q query parameter:- BillToAccountId; integer; The bill-to account ID.
- BillToAccountNumber; string; The bill-to account number.
- BillToSiteNumber; string; The bill-to site number.
- BillToSiteUseId; integer; The bill-to site use ID.
- BusinessUnitId; integer; The business unit ID.
- Currency; string; The currency of the preview subscription.
- DocumentFiscalClassification; string; The document fiscal classification.
- EndDate; string; The end date of the subscription.
- ExemptCertificateNumber; string; The exempt certificate number.
- LegalEntityId; integer; The legal entity ID.
- PricingStrategyId; integer; The pricing strategy ID.
- PrimaryPartyId; integer; The unique primary party identifier of the preview subscription.
- PrimaryPartyNumber; string; The primary party number.
- ShipToParty; integer; The ship-to party.
- ShipToPartyNumber; string; The ship-to party number.
- StartDate; string; The start date of the subscription.
- SubscriptionId; integer; The unique subscription identifier of the preview subscription.
- SubscriptionNumber; string; The subscription number of the preview subscription.
- SubscriptionProfileName; string; The subscription profile name.
- TaxClassificationCode; string; The tax classification code.
-
totalResults: boolean
The resource collection representation will include the "estimated row count" when "?totalResults=true", otherwise the count is not included. The default value is "false".
Header Parameters
-
Metadata-Context: string
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version: string
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : previewSubscriptions
Type:
Show Source
object
-
count(required): integer
The number of resource instances returned in the current range.
-
hasMore(required): boolean
Indicates whether more resources are available on the server than the subset returned in the response. If the value is true, then there are more resources to retrieve from the server. The default value is false.
-
items: array
Items
Title:
Items
The items in the collection. -
limit(required): integer
The actual paging size used by the server.
-
links(required): array
Links
Title:
Links
The link relations associated with the resource instance. -
offset(required): integer
The offset value used in the current page.
-
totalResults: integer
The estimated row count when "?totalResults=true", otherwise the count is not included.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : previewSubscriptions-item-response
Type:
Show Source
object
-
BillToAccountId: integer
The bill-to account ID.
-
BillToAccountNumber: string
Maximum Length:
255
The bill-to account number. -
BillToSiteNumber: string
Maximum Length:
255
The bill-to site number. -
BillToSiteUseId: integer
The bill-to site use ID.
-
BusinessUnitId: integer
The business unit ID.
-
Currency: string
Maximum Length:
255
The currency of the preview subscription. -
DocumentFiscalClassification: string
Maximum Length:
255
The document fiscal classification. -
EndDate: string
(date)
The end date of the subscription.
-
ExemptCertificateNumber: string
Maximum Length:
255
The exempt certificate number. -
LegalEntityId: integer
The legal entity ID.
-
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
PricingStrategyId: integer
The pricing strategy ID.
-
PrimaryPartyId: integer
The unique primary party identifier of the preview subscription.
-
PrimaryPartyNumber: string
Maximum Length:
255
The primary party number. -
products: array
Preview Subscription Products
Title:
Preview Subscription Products
Preview subscriptions lets you view a subscription product before creating, updating, or deleting a subscription. -
ShipToParty: integer
The ship-to party.
-
ShipToPartyNumber: string
Maximum Length:
255
The ship-to party number. -
StartDate: string
(date)
The start date of the subscription.
-
SubscriptionId: integer
The unique subscription identifier of the preview subscription.
-
SubscriptionNumber: string
Maximum Length:
255
The subscription number of the preview subscription. -
SubscriptionProfileName: string
Maximum Length:
300
The subscription profile name. -
TaxClassificationCode: string
Maximum Length:
255
The tax classification code.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Preview Subscription Products
Type:
array
Title:
Preview Subscription Products
Preview subscriptions lets you view a subscription product before creating, updating, or deleting a subscription.
Show Source
Nested Schema : link
Type:
Show Source
object
-
href: string
Title:
hyperlink reference
The URI to the related resource. -
kind: string
Title:
kind
Allowed Values:[ "collection", "item", "describe", "other" ]
The kind of the related resource. -
name: string
Title:
name
The name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relation
Allowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]
The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object
-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Nested Schema : previewSubscriptions-products-item-response
Type:
Show Source
object
-
ActionCode: string
Maximum Length:
255
The action code for the preview. -
AlignBillingFrom: string
(date)
The align billing from for the preview.
-
AmendCreditMethod: string
Maximum Length:
255
The amendment credit method. -
AmendDescription: string
Maximum Length:
255
The amendment description. -
amendedProduct: array
Amended Product
Title:
Amended Product
Preview subscriptions lets you view amended subscription product details before creating, updating or deleting a subscription. -
AmendEffectiveDate: string
(date)
The amendment effective date.
-
AmendReason: string
Maximum Length:
255
The amendment reason. -
BillingFrequency: string
The billing frequency of the subscription product.
-
charges: array
Preview Subscription Charges
Title:
Preview Subscription Charges
Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription. -
CloseCreditMethod: string
Maximum Length:
255
The close credit method for the preview. -
ClosedAmount: number
The closed amount.
-
ClosedDate: string
(date)
The closed date.
-
CloseReason: string
Maximum Length:
255
The close reason. -
CopyAdjustments: string
Maximum Length:
255
Indicates whether the adjustments should be copied for the product or not. -
CopyCharges: string
Indicates whether the charges should be copied for the product or not.
-
CopyOneTimeCharges: string
Maximum Length:
255
Indicates whether the one time charges should be copied for the product or not. -
CreditedAmount: number
The credited amount.
-
DefinitionOrganizationId: integer
The definition organization ID.
-
EndDate: string
(date)
The end date of the subscription product.
-
EstimatedTax: number
The estimated tax.
-
ExemptCertificateNumber: string
Maximum Length:
255
The exempt certificate number. -
InventoryItemId: integer
The inventory item ID.
-
ItemUnitOfMeasure: string
The item unit of measure of the subscription product.
-
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
output: array
Preview Subscription Bill Lines
Title:
Preview Subscription Bill Lines
Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription. -
OutputTaxClassification: string
Maximum Length:
255
The output tax classification. -
PriceListId: integer
The price list ID.
-
ProductFiscClassification: string
Maximum Length:
255
The product fiscal classification. -
ProductName: string
The product name of the subscription product.
-
Quantity: number
The quantity of the subscription product.
-
RequestedAlignBillingDate: string
(date)
The requested align billing date.
-
RequestedRatePlanId: integer
The request rate plan identifier of the subscription product.
-
RequestedRatePlanNumber: string
Maximum Length:
255
The requested rate plan number. -
SalesProductType: string
Maximum Length:
255
The sales product type. -
StartDate: string
(date)
The start date of the subscription product.
-
SubscriptionProductPuid: string
Maximum Length:
255
The subscription product PUID. -
SuppressedCreditAmount: number
The suppressed credit amount.
-
TotalContractValue: number
The total contract value.
Nested Schema : Amended Product
Type:
array
Title:
Amended Product
Preview subscriptions lets you view amended subscription product details before creating, updating or deleting a subscription.
Show Source
Nested Schema : Preview Subscription Charges
Type:
array
Title:
Preview Subscription Charges
Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription.
Show Source
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Preview Subscription Bill Lines
Type:
array
Title:
Preview Subscription Bill Lines
Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription.
Show Source
Nested Schema : previewSubscriptions-products-amendedProduct-item-response
Type:
Show Source
object
-
AlignBillingFrom: string
(date)
The align billing from of the amended product.
-
BillingFrequency: string
The billing frequency of the amended product.
-
charges: array
Preview Subscription Charges
Title:
Preview Subscription Charges
Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription. -
EndDate: string
(date)
The end date of the amended product.
-
EstimatedTax: number
The estimated tax of the amended product.
-
InventoryItemId: integer
The inventory item ID of the amended product.
-
ItemUnitOfMeasure: string
The item unit of measure of the amended product.
-
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
output: array
Preview Subscription Bill Lines
Title:
Preview Subscription Bill Lines
Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription. -
PriceListId: integer
The price list ID of the amended product.
-
ProductName: string
The name of the amended product.
-
Quantity: number
The quantity of the amended product.
-
RequestedAlignBillingDate: string
(date)
The requested align billing date of the amended product.
-
RequestedRatePlanId: integer
The requested rate plan ID of the amended product.
-
RequestedRatePlanNumber: string
Maximum Length:
255
The requested rate plan number of the amended product. -
StartDate: string
(date)
The start date of the amended product.
-
TotalContractValue: number
The total contract value of the amended product.
Nested Schema : Preview Subscription Charges
Type:
array
Title:
Preview Subscription Charges
Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription.
Show Source
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Preview Subscription Bill Lines
Type:
array
Title:
Preview Subscription Bill Lines
Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription.
Show Source
Nested Schema : previewSubscriptions-products-amendedProduct-charges-item-response
Type:
Show Source
object
-
adjustments: array
Subscription Charge Adjustment
Title:
Subscription Charge Adjustment
-
BillingFreq: string
Maximum Length:
255
The billing frequency of the subscription product charge. -
ChargeDefinition: string
The charge definition of the charge.
-
ChargeName: string
The charge name of the charge.
-
EstimatedAmount: number
The estimated amount of the charge.
-
EstimatedQuantity: number
The estimated quantity of a charge.
-
EstimationMethod: string
Maximum Length:
255
The estimation method of the charge. -
InvoicingRuleId: integer
The invoicing rule ID.
-
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
PeriodicBillingFlag: boolean
Maximum Length:
255
The period billing indicator. -
PricePeriodicity: string
The price periodicity of the charge.
-
PriceType: string
The price type of the charge.
-
QuotedTcv: number
The quoted TCV of the charge.
-
UnitListPrice: number
The unit list price of the charge.
Nested Schema : Subscription Charge Adjustment
Type:
array
Title:
Show Source
Subscription Charge Adjustment
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : previewSubscriptions-products-amendedProduct-charges-adjustments-item-response
Type:
Show Source
object
-
AdjustmentBasis: string
Maximum Length:
255
-
AdjustmentName: string
Maximum Length:
255
-
AdjustmentType: string
Maximum Length:
255
-
AdjustmentValue: number
-
AutoAdjustmentFlag: boolean
Maximum Length:
255
-
Effectivity: string
Maximum Length:
255
-
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
NumberOfPeriods: number
-
PeriodFrom: number
-
PeriodUntil: number
-
SequenceNumber: integer
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : previewSubscriptions-products-amendedProduct-output-item-response
Type:
Show Source
object
-
BillLineHeader: string
Maximum Length:
255
The bill line header of the bill lines. -
BillLineValues: string
The bill line values of the bill lines.
-
ChargeAdjustmentHeader: string
Maximum Length:
255
The charge adjustment header of the preview. -
ChargeHeader: string
Maximum Length:
255
The charge header of the preview. -
ChargeValues: string
The charge values of the preview.
-
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
NumberOfBillingCycles: integer
The number of billing cycles for preview.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : previewSubscriptions-products-charges-item-response
Type:
Show Source
object
-
adjustments: array
Subscription Charge Adjustment
Title:
Subscription Charge Adjustment
-
BillingFreq: string
Maximum Length:
255
The billing frequency of the subscription product charge. -
ChargeDefinition: string
The charge definition of the charge.
-
ChargeName: string
The charge name of the charge.
-
EstimatedAmount: number
The estimated amount of the charge.
-
EstimatedQuantity: number
The estimated quantity of a charge.
-
EstimationMethod: string
Maximum Length:
255
The estimation method of the charge. -
InvoicingRuleId: integer
The invoicing rule ID.
-
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
PeriodicBillingFlag: boolean
Maximum Length:
255
The period billing indicator. -
PricePeriodicity: string
The price periodicity of the charge.
-
PriceType: string
The price type of the charge.
-
QuotedTcv: number
The quoted TCV of the charge.
-
UnitListPrice: number
The unit list price of the charge.
Nested Schema : Subscription Charge Adjustment
Type:
array
Title:
Show Source
Subscription Charge Adjustment
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : previewSubscriptions-products-charges-adjustments-item-response
Type:
Show Source
object
-
AdjustmentBasis: string
Maximum Length:
255
-
AdjustmentName: string
Maximum Length:
255
-
AdjustmentType: string
Maximum Length:
255
-
AdjustmentValue: number
-
AutoAdjustmentFlag: boolean
Maximum Length:
255
-
Effectivity: string
Maximum Length:
255
-
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
NumberOfPeriods: number
-
PeriodFrom: number
-
PeriodUntil: number
-
SequenceNumber: integer
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : previewSubscriptions-products-output-item-response
Type:
Show Source
object
-
BillLineHeader: string
Maximum Length:
255
The bill line header of the bill lines. -
BillLineValues: string
The bill line values of the bill lines.
-
ChargeAdjustmentHeader: string
Maximum Length:
255
The charge adjustment header of the preview. -
ChargeHeader: string
Maximum Length:
255
The charge header of the preview. -
ChargeValues: string
The charge values of the preview.
-
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
NumberOfBillingCycles: integer
The number of billing cycles for preview.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source