TAtalon
Catalogs

Get summary of price history

Changed on

[!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.

post/v1/applications/{applicationId}/price_history

Request

Path parameters

applicationIdinteger required

The ID of the Application. It is displayed in your Talon.One deployment URL.

Request body

skustring required

The SKU of the item for which the price records are being retrieved.

startDatestring date-time required

The start date of the period for which price records should be retrieved.

endDatestring date-time required

The end date of the period for which price records should be retrieved.

Example request

{
  "sku": "SKU1241028",
  "startDate": "2020-11-10T23:00:00Z",
  "endDate": "2020-12-10T23:00:00Z"
}

Response

Ok

skustring required

The SKU of the item for which price records should be retrieved.

Example response

{
  "sku": "SKU1241028",
  "history": [
    {
      "id": 1,
      "observedAt": "2025-11-10T23:00:00Z",
      "contextIds": [
        "SpringSale",
        "SummerSale2025"
      ],
      "price": 99.99,
      "metadata": {
        "adjustmentDetails": {
          "referenceId": "68851723-e6fa-488f-ace9-112581e6c19b",
          "selectedPriceType": "member"
        }
      },
      "target": {
        "audience": {
          "integrationId": "382370BKDB946"
        }
      },
      "excludedAt": "2025-11-10T23:00:00Z",
      "exclusionReason": "Incorrect contextID value"
    }
  ]
}

Changes

  • 7ef1b9504c3aRevision changes
    • warning

      removed the optional property // from the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status