Get all pricelists
get
https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/pricelist
Returns a list of pricelists that match the search criteria.
Request
Query Parameters
-
description: string
The description of the resource.
-
eligibleForProject: string
The project ID.
-
fields: string
The comma-separated field names that are returned in the response. The field names are the names that you specify when you create or retrieve a resource.
-
id: string
The unique ID of the resource item.
-
lastUpdate: string
Filters resources by their last update date and time.
-
lifecycleStatus: string
The current lifecycle status of the resource.
-
limit: integer
The number of resources to be returned in the response. The minimum value that can be specified is 1, and the maximum value that can be specified is 100,000. If the specified value is greater than 100,000, then it defaults to 100,000.
-
name: string
The name of the resource.
-
offset: string
The record number from which the retrieval starts. The default value is zero. If no value is specified, then it defaults to zero. The value zero indicates that the retrieval will start from the beginning of the collection.
-
project.id: string
The ID of the project for filtering resource results.
-
project.version: string
The project version for filtering entities.
-
validFor.endDateTime: string
The valid for end date time for filtering entities.
-
validFor.startDateTime: string
The valid for start date time for filtering entities.
-
whereUsed: string
Whether to enrich objects with usedBy information.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
The list of pricelists was returned successfully.
Root Schema : schema
Type:
Show Source
array-
Array of:
object PricelistOracle
Title:
PricelistOracleA list of offers and its coresponding prices which can be used for selling the offer in a region or a particular set of customers.
Nested Schema : PricelistOracle
Type:
objectTitle:
PricelistOracleA list of offers and its coresponding prices which can be used for selling the offer in a region or a particular set of customers.
Show Source
-
@baseType: string
The base type of the pricelist.
-
@schemaLocation: string
The URI of the schema that defines the pricelist.
-
@type(required): string
The class type of the pricelist.
-
applicationName: string
The name of the application associated with the pricelist.
-
balanceElement: object
BalanceElementRef
Title:
BalanceElementRefThe balance element ref in price. -
businessUnitId: number
The ID of the business unit associated with the pricelist.
-
businessUnitName: string
The name of the business unit associated with the pricelist.
-
created: string
(date-time)
The date and time of the creation.
-
createdBy: string
The name of the person who created item.
-
currency: string
The currency (ISO4217 norm uses 3 letters to define the currency).
-
description: string
The description of the pricelist.
-
externalId: string
The ID of the external associated with the pricelist.
-
href: string
The hyperlink reference to the pricelist.
-
id: string
Maximum Length:
30The ID of the pricelist. -
lastUpdate: string
(date-time)
The date and time when the pricelist was last updated.
-
lastUpdatedBy: string
The name of the person who updated item.
-
lifecycleStatus: string
The status of the pricelist.
-
name: string
The name of the pricelist.
-
pricelistType: string
Allowed Values:
[ "RESIDENTIAL", "BUSINESS" ]The type or classification of the pricelist. Valid values are RESIDENTIAL, and BUSINESS. -
productOffering: array
productOffering
A list of product offerings associated with the pricelist.
-
project: object
ProjectRef
Title:
ProjectRefThe project reference resource. -
promotion: array
promotion
A list of promotions associated with the pricelist.
- relatedParty: array relatedParty
-
validFor: object
TimePeriod
Title:
TimePeriodThe period for which the productOffering is valid. -
version: string
The promotion version.
-
versionState: number
The version state of the price list.
Nested Schema : BalanceElementRef
Type:
objectTitle:
BalanceElementRefThe balance element ref in price.
Show Source
-
@baseType: string
The base type of the balance element reference.
-
@referredType(required): string
The type of the referred balance element reference.
-
@schemaLocation: string
The URI of the schema that defines the balance element reference.
-
@type(required): string
The class type of the balance element reference.
-
href: string
The hyperlink reference to the balance element reference.
-
id(required): string
The ID of the balance element reference.
-
name: string
The name of the balance element reference.
-
version: string
The version of the balance element.
-
versionState: number
The version state of the reference.
Nested Schema : productOffering
Type:
arrayA list of product offerings associated with the pricelist.
Show Source
-
Array of:
object ProductOfferingRef
Title:
ProductOfferingRefDiscriminator:{ "propertyName":"@type", "mapping":{ "ProductOfferingRef":"#/components/schemas/ProductOfferingRef", "BundledProductOffering":"#/components/schemas/BundledProductOffering", "BundledProductOfferingChoiceOracle":"#/components/schemas/BundledProductOfferingChoiceOracle", "BundledProductOfferingOracle":"#/components/schemas/BundledProductOfferingOracle" } }The productOffering reference. A product offering represents entities that are orderable from the provider of the catalog, this resource includes pricing information.
Nested Schema : ProjectRef
Type:
objectTitle:
ProjectRefThe project reference resource.
Show Source
-
href: string
The hyperlink reference to the project reference.
-
id(required): string
The ID of the project reference.
-
name: string
The name of the project reference.
-
version: string
The version of the project.
Nested Schema : promotion
Type:
arrayA list of promotions associated with the pricelist.
Show Source
-
Array of:
object PromotionRef
Title:
PromotionRefThe promotion reference.
Nested Schema : TimePeriod
Type:
objectTitle:
TimePeriodThe period for which the productOffering is valid.
Show Source
-
endDateTime: string
(date-time)
The end date and time of the time period.
-
startDateTime: string
(date-time)
The start date and time of the time period.
Nested Schema : ProductOfferingRef
Type:
objectTitle:
ProductOfferingRefDiscriminator: @type
Discriminator Values
- ProductOfferingRef
- BundledProductOffering
- BundledProductOfferingChoiceOracle
- BundledProductOfferingOracle
The productOffering reference. A product offering represents entities that are orderable from the provider of the catalog, this resource includes pricing information.
Show Source
-
@baseType: string
The base type of the product offering reference.
-
@referredType(required): string
The type of the referred product offering reference.
-
@schemaLocation: string
The URI of the schema that defines the product offering reference.
-
@type(required): string
The class type of the product offering reference.
-
href: string
The hyperlink reference to the product offering reference.
-
id(required): string
The ID of the product offering reference.
-
name: string
The name of the product offering reference.
-
version: string
The version of the product offering.
-
versionState: number
The version state of the reference.
Nested Schema : PromotionRef
Type:
objectTitle:
PromotionRefThe promotion reference.
Show Source
-
@baseType: string
The base type of the promotion reference.
-
@referredType(required): string
The type of the referred promotion reference.
-
@schemaLocation: string
The URI of the schema that defines the promotion reference.
-
@type(required): string
The class type of the promotion reference.
-
href: string
The hyperlink reference to the promotion reference.
-
id(required): string
The ID of the promotion reference.
-
name: string
The name of the promotion reference.
Nested Schema : RelatedParty
Type:
objectTitle:
RelatedPartyThe relatedParty reference. A related party defines party or party role linked to a specific entity.
Show Source
-
@baseType: string
The base type of the related party reference or party role reference.
-
@schemaLocation: string
A URI to a JSON-Schema file that defines additional attributes and relationships.
-
@type(required): string
The class type of the related party reference or party role reference.
-
partyOrPartyRole(required):
partyOrPartyRole
A list of party or party roles associated with the related party reference or party role reference.
-
role: string
The role played by the related party or party role in the context of the specific entity it is linked to. Such as 'initiator', 'customer', 'salesAgent', 'user'.
Nested Schema : partyOrPartyRole
Type:
arrayA list of party or party roles associated with the related party reference or party role reference.
Show Source
400 Response
Your request couldn't be processed because it contains missing or invalid information, such as a validation error on an input field, a missing required value, and so forth.
Root Schema : Error
Type:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list).
-
message: string
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
401 Response
Your request isn't authorized. The authentication credentials included with this request are missing or invalid.
Root Schema : Error
Type:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list).
-
message: string
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
404 Response
The resource with the specified URI couldn't be found.
Root Schema : Error
Type:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list).
-
message: string
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
405 Response
HTTP action specified in the request (DELETE, GET, POST, PUT) isn't supported for this request URI.
Root Schema : Error
Type:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list).
-
message: string
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
500 Response
The server encountered something unexpected that prevented it from completing the request.
Root Schema : Error
Type:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list).
-
message: string
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
Examples
The following example shows how to get all pricelists by submitting a GET request on the REST resource using cURL.
cURL Command
curl -u username:password -X GET \
https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/pricelist \ -H 'Content-Type: application/json'Example of Response Body
The following shows the contents of the response body in JSON format.
[
{
"lastUpdate": "2025-02-17T12:34:59.052Z",
"lastUpdatedBy": "booth",
"created": "2025-02-17T12:34:59.000Z",
"createdBy": "booth",
"versionState": 0,
"id": "DBE_NA_PL1",
"href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/pricelist/DBE_NA_PL1",
"name": "DBE NA Pricelist1",
"description": "DBE NA Pricelist",
"@type": "PricelistOracle",
"version": "1.0",
"validFor": {
"startDateTime": "2024-07-22T00:00:00.000Z"
},
"project": {
"id": "DBE_RI_ProdModel_PreSeed_PSP",
"name": "DBE RI Product Model Preseed",
"href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/project/DBE_RI_ProdModel_PreSeed_PSP",
"version": "1.0",
"@referredType": "ProjectOracle"
},
"lifecycleStatus": "In design",
"currency": "USD",
"pricelistType": "BUSINESS"
},
{
"lastUpdate": "2025-02-17T12:34:59.052Z",
"lastUpdatedBy": "booth",
"created": "2025-02-17T12:34:59.000Z",
"createdBy": "booth",
"versionState": 0,
"id": "DBE_CENT_PL1",
"href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/pricelist/DBE_CENT_PL1",
"name": "DBE Central Pricelist1",
"description": "DBE Central Pricelist",
"@type": "PricelistOracle",
"version": "1.0",
"validFor": {
"startDateTime": "2024-07-22T00:00:00.000Z"
},
"project": {
"id": "DBE_RI_ProdModel_PreSeed_PSP",
"name": "DBE RI Product Model Preseed",
"href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/project/DBE_RI_ProdModel_PreSeed_PSP",
"version": "1.0",
"@referredType": "ProjectOracle"
},
"lifecycleStatus": "In design",
"currency": "USD",
"pricelistType": "BUSINESS"
}
]