---
title: "Interaction Log - Retrieves interaction events"
method: GET
path: "/analysis/interactions/{sessionID}"
tags: ["Evidence"]
---

# Interaction Log - Retrieves interaction events

`GET /analysis/interactions/{sessionID}`

View a log of interaction events within the session, including queries, injected facts, questions asked, answers given and results returned.<br><br> **Note:** interaction log recording is switched **off** by default. It must be enabled in the Studio per version per knowledge map. Only sessions started **after** it is enabled will be recorded.

## Path parameters

- `sessionID` string, required

## Query parameters

- `format` string

## Response `200`

Interaction log detail

- object
  - `values` union — The object that contains the specific interaction log
    - object — Start event retrieved via the interaction log
      - `start` object
        - `useDraft` boolean — Whether the current draft of the knowledge map is being used
        - `kmVersion` string — ID of the version being queried, which will be different to the knowledge map ID when querying live versions of a knowledge map
        - `sessionID` string — The sessionID the interaction log is based on
    - object — Questions event retrieved via the interaction log
      - `questions` object[]
        - `subject` string — The subject side concept instance or value
        - `relationship` string — The relationship between subject and object
        - `object` union — The object side concept instance or value
          - string
          - number
          - boolean
        - `prompt` string — User interaction required for further processing
    - object — Query event retrieved via the interaction log
      - `query` object
        - `subject` string — The subject side concept instance or value
        - `relationship` string — The relationship between subject and object
        - `object` union — The object side concept instance or value
          - string
          - number
          - boolean
    - object — Answers event retrieved via the interaction log
      - `answers` object[]
        - `subject` string — The subject side concept instance or value
        - `relationship` string — The relationship between subject and object
        - `object` union — The object side concept instance or value
          - string
          - number
          - boolean
        - `certainty` number — How certain this fact or answer is
    - object — Results event retrieved via the interaction log
      - `results` object[]
        - `subject` string — The subject side concept instance or value
        - `relationship` string — The relationship between subject and object
        - `object` union — The object side concept instance or value
          - string
          - number
          - boolean
        - `certainty` number — How certain this fact or answer is
    - object — Inject event retrieved via the interaction log
      - `facts` object[]
        - `subject` string — The subject side concept instance or value
        - `relationship` string — The relationship between subject and object
        - `object` union — The object side concept instance or value
          - string
          - number
          - boolean
        - `certainty` number — How certain this fact or answer is
    - object — Datasource event retrieved via the interaction log
      - `datasources` object[]
        - `relationship` string — The relationship between subject and object
        - `certainty` number — How certain this fact or answer is
  - `event` string — The interaction event name
  - `created` string — The creation time of the specific interaction

---

[API](https://skmtc.net/rainbird/apis/rainbird-api-documentation.md) · [All operations](https://skmtc.net/rainbird/apis/rainbird-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rainbird/rainbird-api-documentation/revisions/0b8d2bc38f5d/schema)