---
title: "Paginated list of interactions across many locations (rollup scope)."
method: GET
path: "/api/v4/rollup_interactions"
tags: ["Reviews"]
---

# Paginated list of interactions across many locations (rollup scope).

`GET /api/v4/rollup_interactions`

Returns a cursor-paginated list of interactions across many locations in the account, with filtering and sorting.

## Query parameters

- `tag` string
- `locationFilters` string — JSON-encoded filter object
- `siteUrls` string — JSON-encoded filter object
- `startDate` string
- `endDate` string
- `searchString` string
- `category` string
- `categories` string — JSON-encoded filter object
- `ratingFilters` string — JSON-encoded filter object
- `ratingFilter` integer
- `responseStatus` string — JSON-encoded filter object
- `sortOrder` string — JSON-encoded filter object
- `first` integer
- `after` string
- `last` integer
- `before` string

## Response `200`

Successful response

- object
  - `edges` object[], required
    - `node` InteractionConnection, required — Relay-style paginated list of interactions with aggregate stats.
      - `pageInfo` PageInfo, required — (also defined by interactions) (also defined by v2app) (also defined by scantool) (also defined by thirdeye)
        - `hasNextPage` boolean
        - `hasPreviousPage` boolean
      - `edges` InteractionEdge[]
        - `node` Interaction — A single review, Q&A item, or social interaction collected from a source site.
          - `id` string
          - `interactionId` string
          - `source` string
          - `title` string
          - `content` string
          - `authorName` string
          - `rating` integer
          - `date` string
          - `permalink` string
          - `category` string
          - `type` string
          - `responded` boolean
          - `notes` string
          - `responses` InteractionResponse[]
            - `id` string
            - `interactionId` string
            - `content` string
            - `authorName` string
            - `date` string
            - `respondedWith` string
            - `respondedBy` integer
            - `interactionStatus` 'CREATED' | 'FAILED' | 'COMPLETED' | 'CONFIRMED' — Lifecycle state of a response item as it's posted out to the source site.
            - `editedResponse` boolean
            - `remarks` string
          - `responseCount` integer
          - `canRespond` boolean
          - `locationId` integer
          - `flaggedReason` string
        - `cursor` string, required
      - `totalCount` integer
      - `interactionStats` InteractionsCombinedStats
        - `sitesStats` SiteInteractionCount[]
          - `name` string
          - `interactionCount` integer
        - `otherStats` InteractionStat[]
          - `name` string
          - `value` number, float
          - `delta` number, float
          - `abs` number, float
    - `cursor` string, required
  - `pageInfo` object, required
    - `hasNextPage` boolean, required
    - `hasPreviousPage` boolean, required
    - `endCursor` string, nullable
    - `total` integer, nullable
  - `totalCount` integer

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Server error

---

[API](https://skmtc.net/listingsapi/apis/listings-api.md) · [All operations](https://skmtc.net/listingsapi/apis/listings-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/listingsapi/listings-api/versions/9274a1eac380/schema)