younifyd
Menu

Price History

Get summary of price history

POST/v1/applications/{applicationId}/price_history

Use it in a workflow

  1. Add a step and choose the Talon.One connector.
  2. Pick the Price History action (under management).
  3. Fill in the fields below, then reference the result from later steps as {{priceHistory.response.data}}.

Request

Path parameters

applicationIdinteger (int64)required

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

Request body

Enter the body as JSON in the step's Body field.

skustringrequired

The SKU of the item for which the historical prices are being retrieved.

startDatestring (date-time)required

The start date of the period for which historical prices should be retrieved.

endDatestring (date-time)required

The end date of the period for which historical prices should be retrieved.

json
{
  "sku": "",
  "startDate": {},
  "endDate": {}
}

Response

Returns 200 with an object. Read it in later steps with {{priceHistory.response.data.<field>}}.

skustring

The SKU of the item for which historical prices should be retrieved.

historyarray<object>
idinteger (int64)required

The ID of the historical price.

observedAtstring (date-time)required

The date and time when the price was observed.

contextIdstringrequired

Identifier of the relevant context at the time the price was observed (e.g. summer sale).

pricenumberrequired

Price of the item.

metadataobjectrequired2 fields

Auxiliary data for found price observation.

targetobjectrequired
json
{
  "sku": "",
  "history": [
    {
      "metadata": {
        "adjustmentDetails": {
          "selectedPriceType": "member",
          "value": 1.4658129805029452,
          "referenceId": "68851723-e6fa-488f-ace9-112581e6c19b"
        },
        "influencingCampaignDetails": [
          {
            "campaignId": 0,
            "discountValue": 6.027456183070403
          },
          {
            "campaignId": 0,
            "discountValue": 6.027456183070403
          }
        ]
      },
      "observedAt": {},
      "price": 99.99,
      "contextId": "Summer Sale 2025",
      "id": 1,
      "target": "{}"
    }
  ]
}

Need more? See the Talon.One guide for connection setup and behaviour shared by every action.