Get a subscription balance register allowance grant
get
/crmRestApi/resources/11.13.18.05/subscriptionBalanceRegisters/{BalanceRegisterNumber}/child/registerAllowances/{AllowanceGrantNumber}
Request
Path Parameters
-
AllowanceGrantNumber(required): string
The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
-
BalanceRegisterNumber(required): string
The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
Query Parameters
-
dependency: string
This parameter specifies dependencies which are fields that are set before and rolled back after generating the response. Generally they are used to preview the effects of an attribute change. The fields specified in this parameter are always set in the resource instance in question. When a child resource collection is requested and the parameter is set, the fields will be set in the parent resource instance before generating the resource collection payload. The value of this query parameter is a set of dependency fields. Example: dependency=ProductId=2
Format: <attr1>=<val1>,<attr2>=<value2> -
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 -
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 -
onlyData: boolean
The resource item payload will be filtered in order to contain only data (no links section, for example).
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 : subscriptionBalanceRegisters-registerAllowances-item-response
Type:
Show Source
object-
AllowanceEffectiveEndDate: string
(date)
Title:
Effective End DateRead Only:trueThe date from when allowance is effective. -
AllowanceEffectiveStartDate: string
(date)
Title:
Effective Start DateRead Only:trueThe date till which allowance is effective. -
AllowanceGrantId: integer
(int64)
The balance register allowance grant identifier of the subscription balance register allowance grants.
-
AllowanceGrantNumber: string
Title:
Allowance Grant NumberMaximum Length:120The balance register allowance grant number of the subscription balance allowance grants. -
Amount: number
Title:
AmountThe amount of the subscription balance allowance grants. -
BalanceCode: string
Title:
Balance CodeRead Only:trueMaximum Length:30The balance code of the subscription balance allowance grants. -
BalanceCodeMaxPrecision: integer
(int32)
Title:
Maximum PrecisionRead Only:trueThe maximum precision of balance code for the subscription balance allowance grants. -
BalanceCodeType: string
Title:
Balance Code TypeMaximum Length:30The balance code type for the subscription balance allowance grants. -
BalanceRegisterId: integer
(int64)
The balance register identifier of the subscription balance allowance grants.
-
BalanceRegisterPeriodId: integer
(int64)
The balance register period identifier of the subscription balance allowance grants.
-
BalanceRegisterPeriodNumber: string
Title:
Register Period NumberRead Only:trueMaximum Length:120The balance register period number of the subscription balance register allowance grants. -
ChargeDefinitionName: string
Title:
ChargeRead Only:trueMaximum Length:80The charge definition name of the subscription balance allowance grants. -
ConsumedAmount: number
Title:
Consumed AmountThe consumed amount of the subscription balance allowance grants. -
ConsumedQuantity: number
Title:
Consumed QuantityThe consumed quantity of the subscription balance allowance grants. -
CreatedBy: string
Read Only:
trueMaximum Length:64The user who created the subscription balance allowance grant. -
CreationDate: string
(date-time)
Read Only:
trueThe date when the subscription balance allowance grant was created. -
CurrencyCode: string
Title:
CurrencyMaximum Length:15The currency code of the subscription balance allowance grants. -
EndDate: string
(date)
Title:
End DateThe date when the allowance grant ends. -
ExtendedPrecision: integer
(int32)
Title:
Extended PrecisionRead Only:trueThe actual extended precision of the subscription balance allowance grants. -
GrantDate: string
(date)
Title:
Grant DateThe date when the allowance is granted. -
LastUpdateDate: string
(date-time)
Read Only:
trueThe date when the subscription balance allowance grant was last updated. -
LastUpdatedBy: string
Read Only:
trueMaximum Length:64The user who has last updated the subscription balance allowance grants. -
LastUpdateLogin: string
Read Only:
trueMaximum Length:32The login of the user who last updated the subscription balance allowance grants. -
LeAllowanceCurrentDate: string
(date)
Title:
DateRead Only:trueThe current legal entity date of the subscription balance allowance grants. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
ObjectVersionNumber: integer
(int32)
The object version number updated after every update of a subscription balance allowance grants.
-
PartyName: string
Title:
CustomerRead Only:trueMaximum Length:360The party name of the subscription balance register allowance grants. -
PartyNumber: string
Title:
Party NumberRead Only:trueMaximum Length:30The party number of the subscription balance register allowance grants. -
ProductClosedDate: string
(date)
Title:
Product Close DateRead Only:trueThe date when the product closes for subscription balance register allowance grants. -
ProductEndDate: string
(date)
Title:
Product End DateRead Only:trueThe product end date of the subscription balance register allowance grants. -
ProductName: string
Title:
Product NameRead Only:trueMaximum Length:300The product name of the subscription balance allowance grants. -
ProductNumber: string
Title:
Product NumberRead Only:trueMaximum Length:300The product number of the subscription balance allowance grants. -
ProductStartDate: string
(date)
Title:
Product Start DateRead Only:trueThe product start date of the subscription balance register allowance grants. -
Quantity: number
Title:
QuantityThe quantity of the subscription balance allowance grants. -
QuantityUnitOfMeasure: string
Title:
UOMMaximum Length:3The quantity unit of measure of the subscription balance allowance grants. -
RemainingAmount: number
Title:
Remaining AmountThe remaining amount of the subscription balance allowance grants. -
RemainingQuantity: number
Title:
Remaining QuantityThe remaining quantity of the subscription balance allowance grants. -
RolloverEndDate: string
(date)
Title:
Rollover End DateThe rollover end date of the subscription balance allowance grants. -
StartDate: string
(date)
Title:
Start DateThe start date of the subscription balance allowance grants. -
SubscriptionBalanceRegisterAdjustments: array
Subscription Balance Register Adjustments
Title:
Subscription Balance Register AdjustmentsThe subscription balance register adjustments resource is used to view the balance adjustments under an allowance grant. -
SubscriptionEndDate: string
(date)
Title:
Subscription End DateRead Only:trueThe subscription end date of the subscription balance register allowance grants. -
SubscriptionNumber: string
Title:
Subscription NumberRead Only:trueMaximum Length:120The subscription number of the subscription balance allowance grants. -
SubscriptionProductPuid: string
Title:
Subscription Product PUIDRead Only:trueMaximum Length:120The subscription product PUID of the subscription balance allowance grants. -
SubscriptionStartDate: string
(date)
Title:
Subscription Start DateRead Only:trueThe subscription start date of the subscription balance register allowance grants. -
TerminatedAmount: number
Title:
Terminated AmountThe terminated amount of the subscription balance register allowance grants. -
TerminatedQuantity: number
Title:
Terminated QuantityThe terminated quantity of the subscription balance register allowance grants.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : Subscription Balance Register Adjustments
Type:
arrayTitle:
Subscription Balance Register AdjustmentsThe subscription balance register adjustments resource is used to view the balance adjustments under an allowance grant.
Show Source
Nested Schema : link
Type:
Show Source
object-
href: string
Title:
hyperlink referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed 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 : subscriptionBalanceRegisters-registerAllowances-SubscriptionBalanceRegisterAdjustments-item-response
Type:
Show Source
object-
AdjustedAmount: number
Title:
Adjusted AmountThe calculated adjusted amount for the subscription balance register adjustment. -
AdjustedQuantity: number
Title:
Adjusted QuantityThe calculated adjusted quantity for the subscription balance register adjustment. -
AdjustmentDescription: string
Title:
DescriptionMaximum Length:120The description of the subscription balance register adjustment. -
AdjustmentName: string
Title:
NameMaximum Length:30The name of the subscription balance register adjustment. -
AdjustmentReasonCode: string
Title:
Adjustment ReasonMaximum Length:30The reason of the subscription balance register adjustment. -
AdjustmentType: string
Title:
Adjustment TypeMaximum Length:30The type of the subscription balance register adjustment. -
AdjustmentValue: number
Title:
ValueThe adjustment value provided by the user of the subscription balance register adjustment. -
BalanceAdjustmentId: integer
(int64)
Title:
Balance Adjustment IDThe identifier of the subscription balance register adjustments. -
BalanceAdjustmentNumber: string
Title:
Balance Adjustment NumberMaximum Length:120The balance adjustment number of the subscription balance register adjustments. -
BalanceAdjustmentPartialPeriodOption: string
Title:
Partial Period OptionMaximum Length:30The balance partial period option of the balance register adjustments. -
BalanceAdjustmentTerminatedPartialPeriodOption: string
Title:
Terminated Partial Period OptionMaximum Length:30The balance terminated partial period option of the balance register adjustments. -
BalanceCodeId: integer
(int64)
Title:
Balance Code IDThe identifier of the balance code associated to the subscription balance register adjustments. -
BalanceCodeMaxPrecision: integer
(int32)
Title:
Maximum PrecisionRead Only:trueThe maximum precision of balance code for the subscription balance register adjustments. -
BalanceCodeType: string
Title:
Balance Code TypeMaximum Length:30The type of balance code for the subscription balance register adjustments. -
BalanceFirstPartialPeriodOption: string
Title:
Balance First Partial Period OptionRead Only:trueMaximum Length:30The first balance partial period option of the product line of the balance register adjustments. -
BalanceLastPartialPeriodOption: string
Title:
Balance Last Partial Period OptionRead Only:trueMaximum Length:30The last balance partial period option of the product line of the balance register adjustments. -
BalanceRegisterId: integer
(int64)
Title:
Balance Register IDThe identifier of balance register of the subscription balance register adjustments. -
BalanceRegisterPeriodId: integer
(int64)
Title:
Balance Register Period IDThe identifier of balance register period of the subscription balance register adjustments. -
BalanceTerminatedPartialPeriodOption: string
Title:
Balance Terminated Partial Period OptionRead Only:trueMaximum Length:30The terminated balance partial period option of the product line of the balance register adjustments. -
CreatedBy: string
Read Only:
trueMaximum Length:64The user who created the subscription balance register adjustment. -
CreationDate: string
(date-time)
Read Only:
trueThe date when the subscription balance register adjustment was created. -
CurrencyCode: string
Title:
Currency CodeMaximum Length:30The currency code of the subscription balance register adjustment. -
EntitlementId: integer
(int64)
Title:
Entitlement IDThe identifier of entitlement for which the balance register adjustment is created. -
EntitlementType: string
Title:
Entitlement TypesMaximum Length:120The type of entitlement for which the balance register adjustment is created. -
ExtendedPrecision: integer
(int32)
Title:
Extended PrecisionRead Only:trueThe actual extended precision of the subscription balance register adjustment. -
LastUpdateDate: string
(date-time)
Read Only:
trueThe date when the subscription balance register adjustment was last updated. -
LastUpdatedBy: string
Read Only:
trueMaximum Length:64The user who last updated the subscription balance register adjustment. -
LastUpdateLogin: string
Read Only:
trueMaximum Length:32The login of the user who last updated the subscription register adjustment. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
NetAdjustedAmount: number
Title:
Net Adjusted AmountThe net adjusted amount of the subscription balance register adjustment. -
NetAdjustedQuantity: number
Title:
Net Adjusted QuantityThe net adjusted quantity of the subscription balance register adjustment. -
ObjectVersionNumber: integer
(int32)
Read Only:
trueThe object version number updated after every update of a subscription balance register adjustment. -
SequenceNumber: number
Title:
Sequence NumberThe sequence number in which subscription balance register adjustment is created. -
SubscriptionProductId: integer
(int64)
Title:
Subscription Product IDThe identifier of the subscription product associated to the subscription balance register adjustment. -
TerminatedAmount: number
Title:
Terminated Adjusted AmountThe adjusted amount of the balance register adjustment that got terminated because the product was close. -
TerminatedQuantity: number
Title:
Terminated Adjusted QuantityThe adjusted quantity of the balance register adjustment that got terminated because the product was close.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- SubscriptionBalanceRegisterAdjustments
-
Parameters:
- AllowanceGrantNumber:
$request.path.AllowanceGrantNumber - BalanceRegisterNumber:
$request.path.BalanceRegisterNumber
The subscription balance register adjustments resource is used to view the balance adjustments under an allowance grant. - AllowanceGrantNumber: