# Get price recommendations for time range Retrieves all price recommendations for a contract within the specified time range. This endpoint returns algorithmic pricing recommendations based on market analysis, competitor pricing, and configured pricing strategies. Only the most recent recommendations are returned when multiple recommendations exist for the same product. - Paginated results for efficient data retrieval - Optional product tag inclusion - Configurable time range filtering - Real-time market-based recommendations Endpoint: GET /api/2/v/contracts/{contractId}/result/pricerecommendations Version: 0.0.7228 Security: BasicAuth, BearerAuth ## Path parameters: - `contractId` (string, required) Unique identifier of the contract Example: "qbcxvb" ## Query parameters: - `startTime` (string, required) for price recommendation retrieval. Format: ISO 8601 date-time in UTC (e.g., ) Example: "2024-01-15T00:00:00Z" - `endTime` (string, required) for price recommendation retrieval. Format: ISO 8601 date-time in UTC (e.g., ) Example: "2024-01-16T23:59:59Z" - `start` (integer, required) Starting index for pagination (0-based) - `limit` (integer) Maximum number of price recommendations to return per page Example: 100 - `includeTags` (boolean) Whether to include product tags in the response Example: true ## Response 200 fields (application/json): - `data` (array, required) - `data.oldPrice` (number) The price of the cheapest offer of the own shop(s) on the relevant domain - `data.deliveryCosts` (number) The delivery costs which were considered for the recommended price - `data.timestamp` (string, required) The timestamp when the price recommendation has been calculated - `data.oldDeliveryCosts` (number) The delivery costs corresponding to - `data.tags` (array, required) Additional information on this product - `data.tags.doubleValue` (number) The double value depends on the decimal separator which has been provided during product import. - `data.tags.integerValue` (integer) The integer value of the tag. It's only defined when the consists solely of digits. - `data.tags.label` (string, required) The name of the tag. It can't be empty. - `data.tags.stringValue` (string, required) The text value of the tag. - `data.tags.booleanValue` (boolean) The boolean value of the tag. It's only set to true when the is "1" or "true". - `data.price` (number, required) The recommended price of the relevant domain - `data.oldPosition` (integer) The old position on the relevant domain - `data.gtin` (number) GTIN of the product - `data.relativePriceChangePercentage` (number) Absolute percentage how the recommended price changed compared to the e.g. 200 stands for 200% which means the recommended price has doubled - `data.newPosition` (integer) The new position on the relevant domain - `data.decisiveStrategyBranchName` (string) The strategy branch name that calculated the price. This is only filled if the Strategy branch that calculated the price was given a name in the strategy tree. It will have the name that was active at the time the price was calculated (see timestamp) - `data.customerProductId` (string) The customer's id of the product - `data.originalMaxPriceBoundary` (number, required) Max price boundary during the time when the price was calculated - `data.relevantDomain` (string) The decisive domain of the price recommendation. It's been determined by the cheapest price recommendation. - `data.originalMinPriceBoundary` (number, required) Min price boundary during the time when the price was calculated - `data.currency` (string, required) The currency of the price recommendation. - `data.productId` (string, required) The internal product id of the pricemonitor - `data.originalTags` (array, required) List of tags which were set during the time when the price has been calculated. ATTENTION: These are historic tags which are maybe outdated or incomplete. - `data.decisiveStrategyTreeLeafNodeId` (integer, required) The leaf node of the strategy branch that calculated the price. This id references the node in the strategy branch that was active at the time the price was calculated (see timestamp) - `meta` (object) This model describes the information passed to the user for a paginated request. - `meta.nextUrl` (string) the url that can be called to retrieve the next page, None if th last page has been requested - `meta.totalSize` (integer, required) the total number of elements that is paginated over - `meta.start` (integer, required) the start index of the currently requested page - `meta.limit` (integer, required) the number of elements in a full page