Get replay events

curl --request GET \
  --url 'https://api-prod.usefini.com/v2/replays/9d4bbcf7-e7e1-44a6-9a64-ff0a12dfe625/events/public' \
  --header 'Authorization: Bearer fini_your_api_key'

import requests

replay_id = "9d4bbcf7-e7e1-44a6-9a64-ff0a12dfe625"
response = requests.get(
    f"https://api-prod.usefini.com/v2/replays/{replay_id}/events/public",
    headers={"Authorization": "Bearer fini_your_api_key"},
)
events = response.json()

const replayId = "9d4bbcf7-e7e1-44a6-9a64-ff0a12dfe625";

const response = await fetch(
  `https://api-prod.usefini.com/v2/replays/${replayId}/events/public`,
  {
    headers: {
      Authorization: "Bearer fini_your_api_key",
    },
  }
);
const events = await response.json();

[
  {
    "id": "0b3a0bf5-c044-487f-93c3-fd4a8452fe96",
    "companyId": "6bc9f4f8-3564-4a9c-8cc0-ea1f1dd66c2d",
    "botId": "2a1cf0f0-f35d-46ad-8e61-a15c86b2b312",
    "interactionId": "9d4bbcf7-e7e1-44a6-9a64-ff0a12dfe625",
    "role": "user",
    "type": "message",
    "createdAt": "2026-07-30T12:18:03.511Z",
    "content": "How do refunds work?",
    "externalCreatedAt": 1785416132511
  },
  {
    "id": "69e64e28-6fd7-47ab-806d-f573a975188f",
    "companyId": "6bc9f4f8-3564-4a9c-8cc0-ea1f1dd66c2d",
    "botId": "2a1cf0f0-f35d-46ad-8e61-a15c86b2b312",
    "interactionId": "9d4bbcf7-e7e1-44a6-9a64-ff0a12dfe625",
    "role": "finibot",
    "type": "message",
    "createdAt": "2026-07-30T12:18:14.904Z",
    "content": "Refunds are available within 30 days.",
    "originalEventId": "f61a9a11-2c3b-4704-8f57-7078854d87cf"
  }
]

GET

replays

{id}

events

public

curl --request GET \
  --url 'https://api-prod.usefini.com/v2/replays/9d4bbcf7-e7e1-44a6-9a64-ff0a12dfe625/events/public' \
  --header 'Authorization: Bearer fini_your_api_key'

import requests

replay_id = "9d4bbcf7-e7e1-44a6-9a64-ff0a12dfe625"
response = requests.get(
    f"https://api-prod.usefini.com/v2/replays/{replay_id}/events/public",
    headers={"Authorization": "Bearer fini_your_api_key"},
)
events = response.json()

const replayId = "9d4bbcf7-e7e1-44a6-9a64-ff0a12dfe625";

const response = await fetch(
  `https://api-prod.usefini.com/v2/replays/${replayId}/events/public`,
  {
    headers: {
      Authorization: "Bearer fini_your_api_key",
    },
  }
);
const events = await response.json();

[
  {
    "id": "0b3a0bf5-c044-487f-93c3-fd4a8452fe96",
    "companyId": "6bc9f4f8-3564-4a9c-8cc0-ea1f1dd66c2d",
    "botId": "2a1cf0f0-f35d-46ad-8e61-a15c86b2b312",
    "interactionId": "9d4bbcf7-e7e1-44a6-9a64-ff0a12dfe625",
    "role": "user",
    "type": "message",
    "createdAt": "2026-07-30T12:18:03.511Z",
    "content": "How do refunds work?",
    "externalCreatedAt": 1785416132511
  },
  {
    "id": "69e64e28-6fd7-47ab-806d-f573a975188f",
    "companyId": "6bc9f4f8-3564-4a9c-8cc0-ea1f1dd66c2d",
    "botId": "2a1cf0f0-f35d-46ad-8e61-a15c86b2b312",
    "interactionId": "9d4bbcf7-e7e1-44a6-9a64-ff0a12dfe625",
    "role": "finibot",
    "type": "message",
    "createdAt": "2026-07-30T12:18:14.904Z",
    "content": "Refunds are available within 30 days.",
    "originalEventId": "f61a9a11-2c3b-4704-8f57-7078854d87cf"
  }
]

Returns the formatted events for one replay conversation. Use this after Get replay when you need the replayed messages and execution details rather than only the replay conversation metadata.

Headers

string

required

Bearer token containing your Fini workspace API key. Format: Bearer fini_... The key needs read scope.

Path parameters

string

required

Replay conversation ID whose events you want to fetch.

curl --request GET \
  --url 'https://api-prod.usefini.com/v2/replays/9d4bbcf7-e7e1-44a6-9a64-ff0a12dfe625/events/public' \
  --header 'Authorization: Bearer fini_your_api_key'

import requests

replay_id = "9d4bbcf7-e7e1-44a6-9a64-ff0a12dfe625"
response = requests.get(
    f"https://api-prod.usefini.com/v2/replays/{replay_id}/events/public",
    headers={"Authorization": "Bearer fini_your_api_key"},
)
events = response.json()

const replayId = "9d4bbcf7-e7e1-44a6-9a64-ff0a12dfe625";

const response = await fetch(
  `https://api-prod.usefini.com/v2/replays/${replayId}/events/public`,
  {
    headers: {
      Authorization: "Bearer fini_your_api_key",
    },
  }
);
const events = await response.json();

Response

Returns an array of formatted event objects.

string

Event ID.

string

Replay conversation ID that owns the event.

enum

Event sender role, such as user or finibot.

string

Message content for the event, when present.

string

Original conversation event copied into or referenced by the replay, when present.

[
  {
    "id": "0b3a0bf5-c044-487f-93c3-fd4a8452fe96",
    "companyId": "6bc9f4f8-3564-4a9c-8cc0-ea1f1dd66c2d",
    "botId": "2a1cf0f0-f35d-46ad-8e61-a15c86b2b312",
    "interactionId": "9d4bbcf7-e7e1-44a6-9a64-ff0a12dfe625",
    "role": "user",
    "type": "message",
    "createdAt": "2026-07-30T12:18:03.511Z",
    "content": "How do refunds work?",
    "externalCreatedAt": 1785416132511
  },
  {
    "id": "69e64e28-6fd7-47ab-806d-f573a975188f",
    "companyId": "6bc9f4f8-3564-4a9c-8cc0-ea1f1dd66c2d",
    "botId": "2a1cf0f0-f35d-46ad-8e61-a15c86b2b312",
    "interactionId": "9d4bbcf7-e7e1-44a6-9a64-ff0a12dfe625",
    "role": "finibot",
    "type": "message",
    "createdAt": "2026-07-30T12:18:14.904Z",
    "content": "Refunds are available within 30 days.",
    "originalEventId": "f61a9a11-2c3b-4704-8f57-7078854d87cf"
  }
]

Errors

401 Unauthorized

The API key is missing, malformed, revoked, or invalid.

403 Forbidden

The API key does not include the read scope required for this route.

500 Internal Server Error

Fini failed while loading events for the replay conversation.

⌘I

​Headers

​Path parameters

​Response

​Errors

Headers

Path parameters

Response

Errors