---
title: "List Interactions"
method: GET
path: "/interactions"
tags: ["Interactions"]
---

# List Interactions

`GET /interactions`

Browse through all conversations in your workspace to understand how users are interacting with your AI. Filter by product or version to focus on specific areas of your application.

## Query parameters

- `limit` number — Maximum number of results to return.
- `offset` number — Offset for pagination.
- `page` number — Page number
- `productId` string, uuid — Filter interactions by product ID.
- `versionId` string, uuid — Filter interactions by version ID.

## Response `200`

Interactions retrieved successfully

- Interaction[] — Array of interactions.
  - `id` string, uuid, required — The interaction ID.
  - `externalId` string, nullable, required — Your external identifier for the interaction.
  - `participantId` string, uuid, required — The user who participated in this interaction.
  - `externalParticipantId` string, nullable, required — Your external identifier for the participant.
  - `organizationId` string, uuid, nullable, required — The organization ID.
  - `organizationExternalId` string, nullable, required — Your external identifier for the organization.
  - `productId` string, uuid, required — The product ID.
  - `versionId` string, uuid, required — The version ID.
  - `model` string, nullable, required — The AI model used.
  - `properties` object — Custom interaction properties.
  - `rating` number, nullable, required — User rating for this interaction.
  - `ratingMin` number, nullable, required — Minimum rating value.
  - `ratingMax` number, nullable, required — Maximum rating value.
  - `feedback` string, nullable, required — User feedback text.
  - `createdAt` string, date-time, required — When the interaction was created.
  - `updatedAt` string, date-time, required — When the interaction was last updated.

## Other responses

- `400` — Bad request - invalid parameters
- `500` — Server error

## Changes

- **2025-11-24** `c1998d918478` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference/changes/interactions/get.md)

---

[API](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference.md) · [All operations](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greenflash-ai/greenflash-api-reference/revisions/c566e560677d/schema)