---
title: "List GI History"
method: GET
path: "/gi/history"
tags: ["General Insights"]
---

# List GI History

`GET /gi/history`

## Request

- Base URL: `https://api.attention.tech/v2`
- URL: `https://api.attention.tech/v2/gi/history`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/attention/apis/attention-service-v2/docs/gi/history/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the history of generalized insights for a specific user. This endpoint allows you to track and analyze the evolution of insights over time, with options to control the response format and pagination.

## Query parameters

- `user_uuid` string, required
- `withoutEnhancingResults` boolean
- `limit` integer
- `offset` integer

## Response `200`

Successfully retrieved the insight history

- GIHistoryResponse
  - `data` GIHistory[]
    - `uuid` string, required
    - `user` object
      - `uuid` string
    - `title` string, required
    - `results` GIResult[], required
      - `uuid` string, required
      - `synthesis` string, required
      - `prompt` string, required
      - `status` 'PENDING' | 'FINISHED', required
      - `filtersUsed` GIFilters
        - `startDate` string, date-time
        - `endDate` string, date-time
        - `teams` GIFilterTeam[], required
          - `teamUUID` string, required
          - `teamName` string, required
        - `teamMembers` GIFilterTeamMember[], required
          - `teamMemberUUID` string, required
          - `teamMemberName` string, required
          - `teamMemberLastName` string, required
          - `teamMemberEmail` string, required
        - `opportunities` GIFilterOpportunities[], required
          - `opportunityUUID` string, required
          - `opportunityName` string, required
        - `conversations` GIFilterConversation[], required
          - `conversationUUID` string, required
          - `conversationTitle` string, required
        - `isInternal` boolean
        - `labels` GILabelFilter[], required
          - `name` string, required
          - `values` string[], required
      - `items` GIResultItem[], required
        - `uuid` string, required
        - `summary` string, required
        - `evidence` GIItemEvidence
          - `conversationsEvidence` GIConversationEvidence[], required
            - `type` 'CONVERSATION', required
            - `conversationUUID` string, required
            - `conversationTitle` string, required
            - `finishedAt` string, date-time
            - `conversationQuotes` ConversationQuote[], required
              - …
      - `conversationsUsed` string[], required
      - `emailsUsed` string[], required
      - `type` 'LIST' | 'TEXT_WITH_SOURCES' | 'SINGLE_QUOTE' | 'QUOTE_LIST' | 'SUMMARY_TABLE' | 'TABLE_QUOTES', required
      - `result` object, required
    - `executionTemplate` GIExecutionTemplate
      - `uuid` string, required
      - `history` GIHistory (recursive)
      - `filters` GIExecutionTemplateFilters
        - `teams` GIFilterTeam[], required
          - `teamUUID` string, required
          - `teamName` string, required
        - `teamMembers` GIFilterTeamMember[], required
          - `teamMemberUUID` string, required
          - `teamMemberName` string, required
          - `teamMemberLastName` string, required
          - `teamMemberEmail` string, required
        - `opportunities` GIFilterOpportunities[], required
          - `opportunityUUID` string, required
          - `opportunityName` string, required
      - `user` User
        - `uuid` string: The unique identifier of the user.
        - `email` string: The email address of the user.
        - `firstName` string: The first name of the user.
        - `lastName` string: The last name of the user.
        - `createdAt` string: The date and time the user was created.
        - `deletedAt` string: The date and time the user was deactivated.
        - `transcriptLang` string: The preferred transcript language for the user.
        - `joinOutsideHostMeetings` boolean: Indicates if the user can join meetings outside their host organization.
        - `realTimeCapabilities` boolean: Indicates if the user has real-time transcription capabilities.
        - `settings` UserSettings
          - `realTimeCapabilitiesOFF` boolean
          - `autoCalculateCRMFields` boolean
          - `joinWhenIAmHostAndAlone` boolean
          - `joinWhenIAmHostWithPeers` boolean
          - `joinWhenPeerIsHost` boolean
          - `joinWhenUnlicensedPeerIsHost` boolean
          - `dealsEnabled` boolean
        - `botName` string: The name of the bot associated with the user.
        - `botImageURL` string: The URL of the bot's profile image.
        - `primaryTeamUUID` string: The UUID of the user's primary team.
        - `organizationRoleUUID` string: The UUID of the user's role in the organization.
        - `roles` Role[]: A list of roles assigned to the user.
          - `uuid` string
          - `name` string
          - `type` string
        - `showReferralScreen` boolean: Whether the user is shown a referral screen.
        - `seatType` string: The type of seat assigned to the user.
        - `teams` Team[]: A list of teams assigned to the user.
          - `uuid` string: Unique identifier of the team
          - `name` string: Name of the team
          - `phrases` string[]: List of keywords or phrases associated with the team
          - `slackConnection` SlackConnection: Represents the Slack integration details for a team
            - `id` string: Slack connection identifier
            - `info` SlackTeamInfo: Information about a connected Slack team
              - …
          - `domain` string: Domain associated with the team
          - `organizerJoinInternalMeetings` boolean: Whether team organizers can join internal meetings
          - `consentEmailEnabled` boolean: Whether email consent is enabled for the team
          - `parentTeamUUID` string: UUID of the parent team if this team is part of a hierarchy
          - `organizationUUID` string: UUID of the organization this team belongs to
          - `children` Team[]: List of child teams if this team has a hierarchical structure
      - `prompt` string, required
      - `period` 'WEEKLY' | 'MONTHLY', required
      - `lastExecutionAt` string, date-time
      - `nextExecutionAt` string, date-time
      - `createdAt` string, date-time
  - `links` Links
    - `self` string
    - `related` string
  - `meta` Meta
    - `pageCount` integer
    - `totalRecords` integer
    - `pageNumber` integer
    - `pageSize` integer

## Other responses

- `401`: Authentication failed - valid API key required
- `default`: Unexpected error occurred while processing the request

---

[API](https://skmtc.dev/attention/apis/attention-service-v2.md) - [All operations](https://skmtc.dev/attention/apis/attention-service-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/attention/apis/attention-service-v2/revisions/cd99c71f42bb?raw)