TAtalon
Customer data

List Application sessions matching the given customer attributes

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

Get a list of the Application sessions matching the provided customer profile attributes.

The match is successful if all the attributes of the request are found in a profile, even if the profile has more attributes that are not present on the request.

post/v1/applications/{applicationId}/sessions_search

Request

Path parameters

applicationIdinteger required

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

Query parameters

pageSizeinteger

The number of items in the response.

skipinteger

The number of items to skip when paging through large result sets.

withTotalResultSizeboolean

When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets.

  • When true: totalResultSize contains the total number of results for this query.
  • When false: Only hasMore is returned, and it is set to true when there are more results than shown on the page.

Request body

attributesobject

Properties to match against a customer profile. All provided attributes will be exactly matched against profile attributes.

integrationIDsstring[]
profileIDsinteger[]

Response

OK

hasMoreboolean
totalResultSizeinteger

Example response

{
  "data": [
    {
      "id": 6,
      "created": "2020-02-07T08:15:22Z",
      "integrationId": "URNGV8294NV",
      "storeIntegrationId": "STORE-001",
      "applicationId": 322,
      "profileId": 138,
      "profileintegrationid": "382370BKDB946",
      "coupon": "BKDB946",
      "referral": "BKDB946",
      "state": "closed",
      "cartItems": [
        {
          "name": "Air Glide",
          "sku": "SKU1241028",
          "quantity": 1,
          "returnedQuantity": 1,
          "remainingQuantity": 1,
          "price": 99.99,
          "category": "shoes",
          "product": {
            "name": "sample_product"
          },
          "weight": 1130,
          "attributes": {
            "image": "11.jpeg",
            "material": "leather"
          },
          "additionalCosts": {
            "shipping": {
              "price": 9
            }
          },
          "selectedPriceType": "member",
          "adjustmentReferenceId": "68851723-e6fa-488f-ace9-112581e6c19b",
          "adjustmentEffectiveFrom": "2021-09-12T10:12:42Z",
          "adjustmentEffectiveUntil": "2021-09-12T10:12:42Z",
          "prices": {
            "member": {
              "price": 90,
              "adjustmentReferenceId": "68851723-e6fa-488f-ace9-112581e6c19b",
              "effectiveFrom": "2025-05-25T00:00:00Z",
              "effectiveUntil": "2025-05-30T00:00:00Z"
            },
            "base": {
              "price": 100
            }
          }
        }
      ],
      "totalDiscounts": 100,
      "total": 200
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.