---
title: "List Interactions by IDs"
method: GET
path: "/reviewDetails"
tags: ["Reviews", "Interactions"]
---

# List Interactions by IDs

`GET /reviewDetails`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/reviewDetails`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/reviewDetails/get.ts> (a function with typed inputs; its response is checked against the schema)

This API retrieves multiple interactions using their unique identifiers in a single request.

**Behavior:**
- Supports batch retrieval for efficiency.
- Ensures only valid interaction IDs return data.
- Returns full interaction details, including content, platform, timestamp, and response status.

## Query parameters

- `interactionIds` string[], required

## Headers

- `Authorization` string, required

## Response `200`

Successful response

- object
  - `data` object
    - `interactionDetails` object
      - `interactions` InteractionV5[]
        - `id` string, uuid: Unique identifier
        - `interactionId` string, uuid: Alternative interaction identifier
        - `source` string: Source platform (e.g., yelp.com)
        - `title` string, nullable: Interaction title if available
        - `content` string, nullable: Interaction content
        - `locationDbId` string, nullable: Database ID of location
        - `locationEncodedId` string: Base64 encoded location ID
        - `authorName` string: Name of author
        - `authorAvatar` string, nullable: URL to author's avatar
        - `authorUrl` string, nullable: URL to author's profile
        - `authorInfo` string, nullable: Additional author information
        - `rating` integer: Rating value (1-5)
        - `date` string, date-time: Interaction timestamp
        - `permalink` string, nullable: URL to original interaction
        - `category` 'Review' | 'Social': Interaction category
        - `type` 'Review' | 'Comment' | 'Post' | 'Photo' | 'Response': Interaction type
        - `photoUrl` string, nullable: URL to interaction photo
        - `photoThumbnailUrl` string, nullable: URL to photo thumbnail
        - `responded` boolean: Whether interaction has been responded to
        - `notes` string, nullable: Account owner's notes
        - `responses` ResponseV3[]: Array of responses
          - `interactionId` string, uuid: Response ID
          - `source` string: Source platform
          - `title` string, nullable: Response title
          - `content` string: Response content
          - `locationDbId` string, nullable: Location database ID
          - `locationEncodedId` string, nullable: Base64 encoded location ID
          - `authorName` string: Responder name
          - `authorAvatar` string, nullable: Responder avatar URL
          - `authorUrl` string, nullable: Responder profile URL
          - `authorInfo` string, nullable: Additional responder info
          - `rating` integer, nullable: Response rating if applicable
          - `date` string, date-time: Response timestamp
          - `permalink` string, nullable: URL to response
          - `category` string: Response category
          - `type` 'Response': Always "Response"
          - `photoUrl` string, nullable: Response photo URL
          - `photoThumbnailUrl` string, nullable: Response photo thumbnail
          - `responded` boolean, nullable: Response status
          - `notes` string, nullable: Notes on response
          - `responseCount` integer, nullable: Number of sub-responses
          - `canRespond` boolean, nullable: Whether sub-responses allowed
          - `totalResponses` integer, nullable: Total sub-responses
          - `locationId` integer, nullable: Location ID
          - `respondedWith` string, nullable: Template used
          - `respondedBy` integer: User ID who responded
          - `interactionStatus` 'CREATED' | 'COMPLETED' | 'CONFIRMED' | 'FAILED': Status of the response
        - `responseCount` integer, nullable: Number of responses
        - `canRespond` boolean: Whether responses are allowed
        - `totalResponses` integer: Total number of responses
        - `locationId` integer: Numeric location ID
        - `respondedWith` string, nullable: Response template used
        - `respondedBy` integer, nullable: User ID who responded

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)