---
title: Migrate Server-to-server API 1.2 to 1.3
slug: product-recommendations/docs/migrating-1-2-1-3
docTags: 
createdAt: 2026-07-30T20:41:30.719Z
---

## Tracking Response

The API response will always contain the pageTrackingId parameter.

You can use this information when tracking on page dynamic searches or Personalized Search & Navigation (legacy) requests.

See the Personalized Search & Navigation (legacy) API document for how to track on-page dynamic searches.

## userAgent

The userAgent parameter becomes mandatory in the tracking request.

## Variant Tracking

You can track product variants on the [Basket page](docId:-M5d9ioC7abM7aw49JYFd) , [Order page](docId:-M5d9ioC7abM7aw49JYFd)  and [Checkout page](docId\:Ivwro7oelZzxxndRDdlks)  pages.

## Search results tracking request

The request payload for search tracking, in particular the searchResults section, has changed to track more accurate information.

### Payload for v1.2:

```csharp
{ 
      "type"          : "searchresults",
      "ip"            : "10.42.37.139",
      "session"       : "155780550/hKugo5RQsqecUpmlWE6EpFWqmalVrJU",
      "cuid"          : "143159800/hKugo5RQsqecUpmlWE6Eo1OklrJYp5U",
      "site"          : "retailer",
      "clientToken"   : "1234abcd5678",
      "channel"       : "web",
      "lang"          : "en-gb",
      "currentURI"    : "www.retailer.com/search.html?term=bags",
      "previousURI"   : "www.retailer.com/home.html",
      "searchResults" : { 
                          "term" : "bags", 
                          "results" : [ 
                                        {"refCode" : "RC1"},
                                        {"refCode" : "RC2"} 
                                      ] 
                        } 
    }
```

### Payload for v1.3:

```csharp
{
      "type"          : "searchresults",
      "ip"            : "10.42.37.139",
      "session"       : "155780550/hKugo5RQsqecUpmlWE6EpFWqmalVrJU",
      "cuid"          : "143159800/hKugo5RQsqecUpmlWE6Eo1OklrJYp5U", 
      "site"          : "retailer", 
      "clientToken"   : "1234abcd5678", 
      "channel"       : "web", 
      "lang"          : "en-gb", 
      "currentURI"    : "www.retailer.com/search.html?term=bags", 
      "previousURI"   : "www.retailer.com/home. html", 
      "userAgent"     : "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.87 Safari/537.36", 
      "searchResults" : { 
                          "term"                        : "bags", 
                          "personalisationAttributesId" : "abcd1234", 
                          "totalNumberOfResults"        : 50, 
                          "pageNumber"                  : 1, 
                          "resultsOnPage"               : 18, 
                          "filters"                     : [{ 
                                                            "filter"   : "colour", 
                                                            "operator" : "IN", 
                                                            "values"   : ["red","orange","yellow"] 
                                                           }, 
                                                           { 
                                                            "filter"   : "price", 
                                                            "operator" : "BW", 
                                                            "values"   : ["0","50"] 
                                                           }, 
                                                           { 
                                                            "filter"   : "size", 
                                                            "operator" : "IN", 
                                                            "values"   : ["XS","S"] 
                                                          }], 
                          "topResults"                  : [ 
                                                            {"refCode" : "RC1"}, 
                                                            {"refCode" : "RC2"}, 
                                                            {"refCode" : "RC3"} 
                                                          ] 
                        } 
    }
```