---
title: "List Calendar Events"
method: GET
path: "/calendar_events/{user_uuid}"
tags: ["Calendar"]
---

# List Calendar Events

`GET /calendar_events/{user_uuid}`

Returns a paginated list of calendar events from a specific user

## Path parameters

- `user_uuid` string, required

## Query parameters

- `dateFrom` string, date-time
- `dateTo` string, date-time
- `page` integer, required
- `size` integer, required

## Response `200`

Successfully retrieved calendar events page

- CalendarEventsPage
  - `pageCount` integer
  - `totalRecords` integer
  - `pageNumber` integer
  - `pageSize` integer
  - `items` CalendarEvent[]
    - `uuid` string
    - `summary` string
    - `description` string
    - `startTime` string, date-time
    - `endTime` string, date-time
    - `notice` GoogleCalendarNotice
      - `type` string
      - `message` string
    - `conversation` Conversation
      - `type` 'conversations'
      - `id` string
      - `attributes` object
        - `uuid` string
        - `transcript` object
        - `boards` ConversationBoard[]
          - `uuid` string
          - `board` Board
            - `uuid` string
            - `name` string
            - `columns` Column[]
              - …
            - `team` Team — Represents a team in the system with its properties and hierarchical structure
              - …
            - `teamUUID` string
          - `battlecards` ConversationBoardBattlecard[]
            - `uuid` string
            - `activatedBattlecardID` string
            - `hidden` boolean
            - `feedbackAction` string
        - `finishedAt` string, date-time
        - `title` string
        - `liveStreamStartedAt` string, date-time
        - `liveStreamEndedAt` string, date-time
        - `talktracks` ConversationTalktrack[]
          - `uuid` string
          - `items` ConversationTalktrackItem[]
            - `uuid` string
            - `activatedItemId` string
            - `done` boolean
        - `createdAt` string, date-time
        - `userUUID` string
        - `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
              - …
            - `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
        - `team` Team — Represents a team in the system with its properties and hierarchical structure
          - `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
        - `teamUUID` string
        - `extractedIntelligence` object
        - `confirmedExtractedIntelligence` object
        - `externalIntelligenceOpportunityID` string, required
        - `crmExportStatus` 'PENDING' | 'EXPORTED' | 'DISMISSED'
        - `archived` boolean
        - `externalOpportunity` CRMExportOpportunity, required
          - `uuid` string
          - `title` string
        - `videoUID` string
        - `videoStatus` 'PENDING' | 'UNAVAILABLE' | 'IMPORTING' | 'READY'
        - `bots` ConversationBot[]
          - `uuid` string
          - `status` BotStatus
            - `code` string
            - `message` string
            - `createdAt` string, date-time
          - `meetingUrl` string — The original meeting URL used to invite the bot
        - `transcriptStatus` string
        - `participants` Participant[]
          - `id` string
          - `email` string
          - `organizer` boolean
          - `name` string
          - `status` string
        - `attendees` Participant[]
          - `id` string
          - `email` string
          - `organizer` boolean
          - `name` string
          - `status` string
        - `referenceable` boolean
        - `private` boolean
        - `mediaStorageStatus` 'PENDING' | 'UNAVAILABLE' | 'IMPORTING' | 'READY'
        - `importStatus` 'NONE' | 'PENDING' | 'IN_PROGRESS' | 'FINISHED' | 'DISCARDED' | 'FAILED'
        - `scorecardResults` ScorecardResult[]
          - `uuid` string
          - `title` string
          - `summary` ScorecardResultSummary
            - `min` integer
            - `max` integer
            - `averageScore` number, float
            - `summaryText` string
          - `items` ScorecardItemResult[]
            - `uuid` string
            - `title` string
            - `status` 'CALCULATED' | 'CALCULATING'
            - `type` 'NUMERIC'
            - `position` integer
            - `numericResult` NumericScorecardResult
              - …
            - `description` string
            - `evidences` string[]
            - `scorecardItemUUID` string
        - `labels` object
        - `labelTagsToFilterIfNA` string[]
        - `deprecatedLabelCategories` string[]
        - `isInternal` boolean
        - `mediaDuration` number, float
        - `dealUUID` string, required
        - `emailTemplateID` string
        - `linkedCrmRecords` LinkedCrmRecord[]
          - `id` string, required
          - `code` string, required
        - `externalAccounts` LinkedCrmRecord[]
          - `id` string, required
          - `code` string, required
        - `externalContacts` LinkedCrmRecord[]
          - `id` string, required
          - `code` string, required
        - `isEmpty` boolean
        - `zoomMetadata` ZoomMetadata, required
          - `calleeName` string, required
          - `calleeNumber` string, required
          - `callerName` string, required
          - `callerNumber` string, required
        - `importMetadata` object, required
        - `zoomMeetingJoinUrl` string — The Zoom meeting join URL if the conversation was recorded from a Zoom meeting
        - `googleMeetJoinUrl` string — The Google Meet join URL if the conversation was recorded from a Google Meet
        - `microsoftTeamsJoinUrl` string — The Microsoft Teams meeting join URL if the conversation was recorded from a Teams meeting
        - `webexJoinUrl` string — The Webex meeting join URL if the conversation was recorded from a Webex meeting
      - `links` Links
        - `self` string
        - `related` string
    - `joinableOverride` CalendarEventJoinable
      - `source` 'DEFAULT' | 'USER' | 'TEAM'
      - `shouldJoin` boolean
      - `reason` string
    - `joinableFinal` CalendarEventJoinable
      - `source` 'DEFAULT' | 'USER' | 'TEAM'
      - `shouldJoin` boolean
      - `reason` string
    - `joinUrl` string
    - `participants` Participant[]
      - `id` string
      - `email` string
      - `organizer` boolean
      - `name` string
      - `status` string

## Other responses

- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.net/attention/apis/attention-service-v2.md) · [All operations](https://skmtc.net/attention/apis/attention-service-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attention/attention-service-v2/versions/5de55d3804cf/schema)