Get a Price Model Item Rate Plan
get
/rest/v19/pricingSetup/models/{modelVariableName}/priceModelItems/{priceModelItemId}/ratePlans/{ratePlanNumber}
Use this endpoint to retrieve the specified pricing rate plan.
Request
Path Parameters
Query Parameters
-
expand: string
When this parameter is provided, the specified children are included in the resource payload (instead of just a link). More than one child can be specified using comma as a separator. Example: ?expand=charges. To include all the children and grandchildren, specify the value of this query parameter to be "all".
-
fields: string
This parameter filters the resource attributes. Only the specified attributes are returned, which means that if no attributes are specified, all attributes are returned.
Response
Supported Media Types
- application/json
200 Response
Success
Root Schema : PricingRatePlan
Type:
Show Source
object-
chargeCount:
integer()
Title:
Associated Charges CountRead Only:trueThe count of charges directly associated with this price model item. -
charges:
Charges
Title:
ChargesRead Only:trueRate Plan charges -
createdBy:
Created By
Title:
Created ByRead Only:trueThe details of the user who created the record. -
dateAdded:
string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
Title:
Date AddedRead Only:trueCreation Date of the Pricing Rate Plan. -
dateModified:
string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
Title:
Date ModifiedRead Only:trueLast Modified date of the Pricing Rate Plan. -
description:
string()
Title:
DescriptionDescription of the Pricing Rate Plan. -
endDate:
string()
Title:
End DateThe date after which the Pricing Rate Plan will no longer be applicable. -
groupAccessEnabled:
boolean()
Title:
Group Access EnabledRead Only:trueIndicates whether the user has access to the groups segment -
integrationId:
string()
Title:
Integration IDThe integration ID of the Pricing rate plan. -
lastModifiedBy:
Last Modified By
Title:
Last Modified ByRead Only:trueThe details of the user who modified the record. -
links:
array Links
Title:
LinksRead Only:trueThe link relations associated with the resource instance. -
name:
string()
Title:
NameName of the Pricing Rate Plan. -
orderNumber:
integer()
Title:
Order NumberThe position in a ordered list of Rate Plan. -
priceModelItemId:
integer()
Title:
Price ModelItem IdRead Only:trueThe Price ModelItem Id. -
priceModelItemIntegrationId:
string()
Title:
Price Model Item Integration IDThe integration ID of the parent Price Model Item. -
ratePlanNumber:
string()
Title:
Rate Plan NumberUnique Variable Name of the Pricing Rate Plan. -
segmentLevelAccessType:
string()
Title:
Segment-level Access TypeRead Only:trueSegment-level Access Type -
startDate:
string()
Title:
Start DateThe date from which the Pricing Rate Plan will be applicable.
Nested Schema : Charges
Title:
ChargesRead Only:
trueRate Plan charges
Match All
Rate Plan charges
Show Source
Nested Schema : Created By
Title:
Created ByRead Only:
trueThe details of the user who created the record.
Match All
The details of the user who created the record.
Show Source
Nested Schema : Last Modified By
Title:
Last Modified ByRead Only:
trueThe details of the user who modified the record.
Match All
The details of the user who modified the record.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksRead Only:
trueThe link relations associated with the resource instance.
Show Source
Nested Schema : PricingResourceCollection_PricingCharge
Type:
Show Source
object-
count:
integer()
Title:
CountRead Only:trueThe number of resource instances returned in the current range. -
createdBy:
Created By
Title:
Created ByRead Only:trueThe details of the user who created the record. -
groupAccessEnabled:
boolean()
Title:
Group Access EnabledRead Only:trueIndicates whether the user has access to the groups segment -
hasMore:
boolean()
Title:
HasMoreRead Only:trueIndicates 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
-
lastModifiedBy:
Last Modified By
Title:
Last Modified ByRead Only:trueThe details of the user who modified the record. -
limit:
integer()
Title:
LimitRead Only:trueThe actual paging size used by the server. -
links:
array Links
Title:
LinksRead Only:trueThe link relations associated with the resource instance. -
offset:
integer()
Title:
OffSetRead Only:trueThe offset value used in the current page. -
segmentLevelAccessType:
string()
Title:
Segment-level Access TypeRead Only:trueSegment-level Access Type -
totalResults:
integer()
Title:
Total ResultsRead Only:trueCaptures the total count of the resource instances, which not only includes the instances in the current range, but all instances on the server that satisfy the request.
Nested Schema : Created By
Title:
Created ByRead Only:
trueThe details of the user who created the record.
Match All
The details of the user who created the record.
Show Source
Nested Schema : Last Modified By
Title:
Last Modified ByRead Only:
trueThe details of the user who modified the record.
Match All
The details of the user who modified the record.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksRead Only:
trueThe link relations associated with the resource instance.
Show Source
Nested Schema : UserDetails
Type:
Show Source
object-
emailId:
string()
Title:
Email IdEmail Id of the user -
firstName:
string()
Title:
First NameFirst Name of the user -
lastName:
string()
Title:
Last NameLast Name of the user
Nested Schema : PricingCharge
Type:
Show Source
object-
blockPrices:
array Block Prices
Title:
Block PricesThe block price. -
blockSize:
number()
Title:
Block SizeThe block size. -
chargeDefinition:
string()
Title:
Charge DefinitionRead Only:trueDisplay Name of the Charge Definition. -
chargeDefinitionCode:
string()
Title:
Charge Definition CodeThe unique code of the Charge Definition. -
chargeDefinitionId:
integer()
Title:
Charge Definition IDRead Only:trueID of the Charge Definition. -
chargeType:
string()
Title:
Charge TypeThe category of charge. -
createdBy:
Created By
Title:
Created ByRead Only:trueThe details of the user who created the record. -
dateAdded:
string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
Title:
Date AddedRead Only:trueCreation date. -
dateModified:
string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
Title:
Date ModifiedRead Only:trueLast modified date. -
dynamicPricingType:
string()
Title:
Dynamic Pricing TypeAllowed Values:[ "static", "advanced", "volume", "tiered", "rateCard", "attributeBasedCharge" ]The dynamic pricing type of the charge. -
endDate:
string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
Title:
End DateThe date at which the Charge will end. -
groupAccessEnabled:
boolean()
Title:
Group Access EnabledRead Only:trueIndicates whether the user has access to the groups segment -
id:
integer()
Title:
IdRead Only:trueThe Unique Identifier of the Charge. -
integrationId:
string()
Title:
Integration IdRate Plan Charge ID from SCM. -
lastModifiedBy:
Last Modified By
Title:
Last Modified ByRead Only:trueThe details of the user who modified the record. -
links:
array Links
Title:
LinksRead Only:trueThe link relations associated with the resource instance. -
pricePeriod:
string()
Title:
Price PeriodThe billing period. -
prices:
array Prices
Title:
PricesThe item prices. -
priceType:
string()
Title:
Price TypeThe type of charge. -
pricingMatrixVariableName:
string()
Title:
Pricing Matrix Variable NamePricing Matrix variable name (Preview only. Not available for use.) -
primaryCharge:
boolean()
Title:
Primary ChargeIndicates whether this is the primary charge. -
quantityAggregation:
boolean()
Title:
Quantity AggregationIndicates whether to use aggregated quantity when calculating unit price for tiered-pricing. -
rateCardName:
string()
Title:
Rate Card NameRead Only:trueRate Card name (Preview only. Not available for use.) -
rateCardVariableName:
string()
Title:
Rate Card Variable NameRate Card variable name (Preview only. Not available for use.) -
segmentLevelAccessType:
string()
Title:
Segment-level Access TypeRead Only:trueSegment-level Access Type -
startDate:
string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
Title:
Start DateThe date from which the Charge will be applicable. -
templateVariableName:
string()
Title:
Pricing Matrix Template Variable NameThe pricing matrix emplate variable name. -
tiers:
array Tiers
Title:
TiersThe charge tiers. -
usageUOM:
string()
Title:
Usage UOMThe unit of measure for the charge.
Nested Schema : Created By
Title:
Created ByRead Only:
trueThe details of the user who created the record.
Match All
The details of the user who created the record.
Show Source
Nested Schema : Last Modified By
Title:
Last Modified ByRead Only:
trueThe details of the user who modified the record.
Match All
The details of the user who modified the record.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksRead Only:
trueThe link relations associated with the resource instance.
Show Source
Nested Schema : PricingCurrencyValues
Type:
Show Source
object-
currencyCode:
string()
Title:
Currency CodeThe currency code. -
value:
number()
Title:
ValueThe currency value.
Nested Schema : ChargeTier
Type:
Show Source
object-
blockPrices:
array Block Prices
Title:
Block PricesThe block price for the corresponding tier. -
blockSize:
number()
Title:
Block SizeThe block size for the corresponding tier. -
prices:
array Prices
Title:
PricesThe prices. -
rangeFrom:
number()
Title:
Range FromThe starting range of the Charge. -
rangeTo:
number()
Title:
Range ToRead Only:trueThe ending range of the Charge.
Nested Schema : Block Prices
Type:
arrayTitle:
Block PricesThe block price for the corresponding tier.
Show Source
Examples
The following example shows how to retrieve the specified the specified Price Model Item Rate Plan by submitting a GET request to the REST resource using cURL. For more information about cURL, see Use cURL.
curl -X GET -H "Authorization: Bearer <token>" -H "Accept: application/json" https://sitename.oracle.com/rest/v19/pricingSetup/models/_defaultPriceModel/priceModelItems/3022952781/ratePlans/ratePlan2
Response Body Sample
{
"dateAdded": "2023-05-05T09:15:56Z",
"dateModified": "2023-05-05T09:15:56Z",
"description": "Rate Plan used for Customer Specific Pricing 02",
"endDate": "2023-09-18T05:18:59Z",
"integrationId": "qpIntegrationId1",
"name": "Rate Plan 1",
"ratePlanNumber": "ratePlan2",
"startDate": "2023-02-18T10:02:14Z",
"priceModelItemId": "3022952781"
}