---
title: "Get summary of price history"
method: POST
path: "/v1/applications/{applicationId}/price_history"
tags: ["Catalogs"]
---

# Get summary of price history

`POST /v1/applications/{applicationId}/price_history`

## Request

- Base URL: `https://yourbaseurl.talon.one`
- URL: `https://yourbaseurl.talon.one/v1/applications/{applicationId}/price_history`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/talon/apis/management-api/docs/v1/applications/:applicationId/price_history/post.ts> (a function with typed inputs; its response is checked against the schema)

> [!note] Management API endpoints are **not** meant to be used in real-time integrations that directly serve your end users. Rate limit: 3 requests per second.

Fetch the price records (historical price data) for a given SKU within a defined timeframe.

You can use this endpoint for auditing purposes and for ensuring that evaluation produced correct price records.

For more information, see [Best prior price](https://docs.talon.one/docs/dev/integration-guides/best-prior-price).

## Path parameters

- `applicationId` integer, required

## Request body

- PriceHistoryRequest
  - `sku` string, required: The SKU of the item for which the price records are being retrieved.
  - `startDate` string, date-time, required: The start date of the period for which price records should be retrieved.
  - `endDate` string, date-time, required: The end date of the period for which price records should be retrieved.

## Response `200`

Ok

- PriceHistoryResponse
  - `sku` string, required: The SKU of the item for which price records should be retrieved.
  - `history` History[], required
    - `id` integer, required: The ID of the price record.
    - `observedAt` string, date-time, required: The date and time from which the price record is effective.
    - `contextIds` string[], required: The identifiers of the relevant context (the sales events, e.g. "Spring Sale", "Summer Sale") at the time from which the price record is effective. Includes the context IDs of any price adjustments and of the campaigns that influenced the final price.
    - `price` number, required: Price of the item.
    - `metadata` BestPriorPriceMetadata, required: Auxiliary data for the found price record.
      - `influencingCampaignDetails` InfluencingCampaignDetails[], required: Details about campaigns that influenced the final price.
        - `campaignId` integer, required: Identifier of the campaign that influenced the final price.
        - `discountValue` number, required: Discount value applied by the campaign.
      - `adjustmentDetails` AdjustmentDetails: Details about an applied price adjustment.
        - `referenceId` string, required: The reference identifier used during an `ADD_PRICE_ADJUSTMENT` action.
        - `selectedPriceType` string, required: The selected price type for the SKU targeted by this effect.
        - `value` number, required: The value of the applied price adjustment.
    - `target` union, required
      - object: Target type when no specific audience is selected. Targets all customers who are not members of an audience.
        - `type` 'NONE', required
      - object: Target type when a specific audience is selected. Talon.One logs a separate price record per audience. You can use this object to compare the price records of a price type to those of a [base price](https://docs.talon.one/docs/dev/integration-guides/best-prior-price#price-history), for example.
        - `type` 'AUDIENCE', required
        - `audience` AudienceReference, required
          - `id` integer, required: The ID of the audience.
          - `integration` string: The third-party integration of the audience.
          - `integrationId` string: The ID of this audience in the third-party integration.
    - `excludedAt` string, date-time: The date and time when the price record was excluded.
    - `exclusionReason` string: The reason for excluding this price record.

## Changes

- **2026-11-07** `7ef1b9504c3a`: 1 warning, 2 info
  - removed the optional property `history/items/contextId` from the response with the `200` status
  - added the optional property `history/items/excludedAt` to the response with the `200` status
  - added the optional property `history/items/exclusionReason` to the response with the `200` status

[Operation history](https://skmtc.dev/talon/apis/management-api/changes/v1/applications/:applicationId/price_history/post.md)

---

[API](https://skmtc.dev/talon/apis/management-api.md) - [All operations](https://skmtc.dev/talon/apis/management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/talon/apis/management-api/revisions/7ef1b9504c3a?raw)