> ## Documentation Index
> Fetch the complete documentation index at: https://developer.meetergo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get current user information

> Retrieves detailed information about the currently authenticated user including their availability schedules, meeting types, and company association.



## OpenAPI

````yaml /openapi.json get /v4/user/me
openapi: 3.0.0
info:
  title: meetergo Platform API
  description: >-
    Comprehensive scheduling API for creating users, managing availability,
    handling bookings, and connecting calendar providers. Enables seamless
    integration with external platforms and applications.
  version: 0.0.0
  contact: {}
  termsOfService: https://www.meetergo.com/tos/
servers: []
security: []
tags:
  - name: User V4
    description: Create and manage users in your workspace
  - name: Meeting Type V4
    description: Configure meeting templates with durations, buffers, and conferencing
  - name: availability
    description: Manage weekly schedules and availability settings
  - name: Booking V4
    description: Create new bookings
  - name: Booking Availability V4
    description: Query available time slots for booking
  - name: Appointment V4
    description: Manage existing appointments
  - name: Attendee V4
    description: Manage attendee details and notes
  - name: Calendar Connections V4
    description: Connect and sync external calendars
  - name: One Time Booking Link V4
    description: Create single-use booking links
  - name: availability-exception
    description: Override availability for specific dates
  - name: Booking Link V4
    description: Configure various booking page types
  - name: Personal Page V4
    description: Manage user profile pages
  - name: Handoff V4
    description: Reassign meetings to other hosts
  - name: Calendar Auth V4
    description: OAuth callbacks for calendar providers
  - name: Queue V4
    description: Round-robin and queue-based routing (Beta)
  - name: Queue User Group V4
    description: Manage queue user groups (Beta)
  - name: Meeting Type Template V4
    description: Reusable meeting type configurations (Beta)
  - name: Attendee Pending V4
    description: Manage pending attendee approvals (Beta)
  - name: Provisional Booking V4
    description: Manage provisional/unconfirmed bookings (Beta)
paths:
  /v4/user/me:
    get:
      tags:
        - User V4
      summary: Get current user information
      description: >-
        Retrieves detailed information about the currently authenticated user
        including their availability schedules, meeting types, and company
        association.
      operationId: getCurrentUser
      parameters: []
      responses:
        '200':
          description: Current user information retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserResponseDto'
      security:
        - ApiUserHeader: []
        - JWT: []
        - ApiKey: []
components:
  schemas:
    UserResponseDto:
      type: object
      properties:
        id:
          type: string
          description: User unique identifier
        companyId:
          type: string
          nullable: true
          description: Company ID the user belongs to
        email:
          type: string
          description: User email address
        isAdmin:
          type: boolean
          description: Whether user is a company administrator
        isScimDisabled:
          type: boolean
          description: Whether user is disabled via SCIM
        familyName:
          type: string
          description: User family name/lastname
        givenName:
          type: string
          description: User given name/firstname
        picture:
          type: string
          description: URL to user profile picture
        createdAt:
          type: string
          description: User creation timestamp
        updatedAt:
          type: string
          description: User last update timestamp
        deletedAt:
          type: string
          nullable: true
          description: User deletion timestamp
        title:
          type: string
          description: User job title
        anonymousBooking:
          type: boolean
          description: Whether user allows anonymous booking
        anonymousCalendarActivity:
          type: boolean
          description: Whether user allows anonymous calendar activity
        slug:
          type: string
          description: User unique slug for public URLs
        showGettingStartedList:
          type: boolean
          description: Whether to show getting started list
        recieveEmailMarketing:
          type: boolean
          description: Whether user receives marketing emails
        timezone:
          type: string
          description: User timezone
        language:
          description: User preferred language
          allOf:
            - $ref: '#/components/schemas/Language'
        referralId:
          type: string
          description: Referral ID if user was referred
        personalPage:
          description: User personal page configuration
          allOf:
            - $ref: '#/components/schemas/PersonalPageResponseDto'
        calendarSyncProviders:
          nullable: true
          description: Calendar sync provider settings
          allOf:
            - $ref: '#/components/schemas/CalendarSync'
        defaultAvailabilityId:
          type: string
          description: Default availability ID
        aircallUserId:
          type: string
          description: Aircall user ID
        phone:
          type: string
          description: User phone number
        userType:
          description: Type of user (standard, resource, api-platform)
          allOf:
            - $ref: '#/components/schemas/UserType'
        wherebyApiKey:
          type: string
          nullable: true
          description: Whereby API key
        fullName:
          type: string
          description: User full name (computed)
        groupIds:
          description: IDs of groups the user belongs to
          type: array
          items:
            type: string
        groupAdminIds:
          description: IDs of groups the user is admin of
          type: array
          items:
            type: string
        meetingTypeIds:
          description: IDs of meeting types owned by the user
          type: array
          items:
            type: string
        meetingTypeTemplateIds:
          description: IDs of meeting type templates created by the user
          type: array
          items:
            type: string
        appointmentIds:
          description: IDs of appointments where user is a host
          type: array
          items:
            type: string
        workspaceIds:
          description: IDs of workspaces the user belongs to
          type: array
          items:
            type: string
        reminderIds:
          description: IDs of reminders owned by the user
          type: array
          items:
            type: string
        formIds:
          description: IDs of forms owned by the user
          type: array
          items:
            type: string
        dealIds:
          description: IDs of deals owned by the user
          type: array
          items:
            type: string
        queueIds:
          description: IDs of queues the user belongs to
          type: array
          items:
            type: string
        queueUserGroupIds:
          description: IDs of queue user groups the user belongs to
          type: array
          items:
            type: string
        availabilityIds:
          description: IDs of availabilities owned by the user
          type: array
          items:
            type: string
        company:
          description: Company basic information
          allOf:
            - $ref: '#/components/schemas/CompanyBasicDto'
      required:
        - id
        - isAdmin
        - isScimDisabled
        - familyName
        - givenName
        - createdAt
        - updatedAt
        - title
        - anonymousBooking
        - anonymousCalendarActivity
        - slug
        - showGettingStartedList
        - recieveEmailMarketing
        - timezone
        - language
        - personalPage
        - userType
        - fullName
    Language:
      type: string
      enum:
        - en
        - de
        - fr
        - es
        - 'no'
        - nl
        - it
        - pl
        - sv
        - tr
        - da
    PersonalPageResponseDto:
      type: object
      properties:
        useCustomColors:
          type: boolean
          description: Whether custom colors are enabled for the personal page
        primaryColor:
          type: string
          description: Primary color for the personal page theme
        secondaryColor:
          type: string
          description: Secondary color for the personal page theme
        headerImage:
          type: string
          nullable: true
          description: Header image URL for the personal page
        description:
          type: string
          description: Personal page description text
        onlineProfiles:
          description: Online profiles and social media links
          allOf:
            - $ref: '#/components/schemas/OnlineProfiles'
        meetingTypes:
          description: Meeting types assigned to this personal page
          type: array
          items:
            $ref: '#/components/schemas/MeetingTypeBasicResponseDto'
      required:
        - useCustomColors
        - primaryColor
        - secondaryColor
        - description
        - onlineProfiles
    CalendarSync:
      type: object
      properties:
        id:
          type: string
        type:
          allOf:
            - $ref: '#/components/schemas/CalendarSyncProvider'
      required:
        - id
        - type
    UserType:
      type: string
      enum:
        - standard
        - resource
        - api-platform
        - partner
    CompanyBasicDto:
      type: object
      properties:
        id:
          type: string
          description: Company unique identifier
        name:
          type: string
          description: Company name
        slug:
          type: string
          description: Company unique slug
        logo:
          type: string
          description: Company logo URL
        description:
          type: string
          description: Company description
        timezone:
          type: string
          description: Company timezone
        language:
          type: string
          description: Company language
      required:
        - id
        - name
        - slug
        - timezone
        - language
    OnlineProfiles:
      type: object
      properties:
        linkedIn:
          type: string
        facebook:
          type: string
        twitter:
          type: string
        instagram:
          type: string
        xing:
          type: string
        phone:
          type: string
        email:
          type: string
        customLinks:
          type: array
          items:
            $ref: '#/components/schemas/CustomLink'
        addressStreet:
          type: string
        addressCity:
          type: string
        addressPostalCode:
          type: string
        addressCountry:
          type: string
      required:
        - linkedIn
        - facebook
        - twitter
        - instagram
        - xing
        - phone
        - email
        - customLinks
        - addressStreet
        - addressCity
        - addressPostalCode
        - addressCountry
    MeetingTypeBasicResponseDto:
      type: object
      properties:
        meetingInfo:
          description: Meeting information (title, description, duration, etc.)
          allOf:
            - $ref: '#/components/schemas/MeetingInfo'
        spots:
          type: number
          description: Number of available spots for the meeting
        enabled:
          type: boolean
          description: Whether the meeting type is enabled
        slug:
          type: string
          description: Meeting type unique slug
        formId:
          type: string
          description: Form ID associated with the meeting type
        communicationSettingsId:
          type: number
          nullable: true
          description: Communication settings ID
        availabilityId:
          type: string
          description: Availability ID associated with the meeting type
        companyId:
          type: string
          description: Company ID that owns this meeting type
        queueId:
          type: string
          description: Queue ID if meeting type uses a queue
        locations:
          description: Available meeting locations
          type: array
          items:
            type: string
        workspaceId:
          type: string
          description: Workspace ID if meeting type belongs to a workspace
        isGlobalQueue:
          type: boolean
          description: Whether this meeting type uses a global queue
        userId:
          type: string
          description: User ID who owns this meeting type
        createdById:
          type: string
          description: User ID who created this meeting type
        createdAt:
          type: string
          description: Creation timestamp
        deletedAt:
          type: string
          description: Deletion timestamp if soft deleted
        resourceChannelIds:
          description: IDs of resource channels associated with this meeting type
          type: array
          items:
            type: string
      required:
        - meetingInfo
        - spots
        - enabled
        - slug
        - companyId
        - locations
        - isGlobalQueue
        - createdById
        - createdAt
    CalendarSyncProvider:
      type: string
      enum:
        - google
        - outlook
        - icloud
        - caldav
        - exchange
        - nextcloud
        - smart-we
        - salesforce
    CustomLink:
      type: object
      properties:
        name:
          type: string
        url:
          type: string
        icon:
          type: string
      required:
        - name
        - url
        - icon
    MeetingInfo:
      type: object
      properties:
        name:
          type: string
          description: Name of the meeting type
        description:
          type: string
          description: Description of the meeting type
        enableRedirect:
          type: boolean
          description: Enable redirect after booking completion
        redirect:
          type: string
          description: Redirect URL to navigate after booking
        passEventDetailsToRedirect:
          type: boolean
          description: >-
            Pass event details (invitee name, email, form answers) as query
            params to redirect URL
        duration:
          type: number
          description: Primary duration in minutes
        channel:
          description: Meeting channel/location type
          allOf:
            - $ref: '#/components/schemas/MeetingTypeChannel'
        customChannelName:
          type: string
          description: Custom name for the meeting channel
        customChannelLink:
          type: string
          description: Custom link for the meeting channel
        groupBooking:
          type: boolean
          description: Enable group booking (multiple attendees per slot)
        showAvailableSlots:
          type: boolean
          description: Show available spots count on the booking page
        enrichInvitee:
          type: boolean
          description: Enable invitee data enrichment
        confirmationButton:
          description: Confirmation button settings
          allOf:
            - $ref: '#/components/schemas/ConfirmationButton'
        bufferBefore:
          type: number
          description: Buffer time before meeting in minutes
        bufferAfter:
          type: number
          description: Buffer time after meeting in minutes
        color:
          type: object
          description: Color for the meeting type in RGB format, e.g. "rgb(0, 153, 255)"
          nullable: true
      required:
        - name
        - description
        - enableRedirect
        - redirect
        - passEventDetailsToRedirect
        - duration
        - channel
        - customChannelName
        - customChannelLink
        - groupBooking
        - showAvailableSlots
        - enrichInvitee
        - confirmationButton
        - bufferBefore
        - bufferAfter
    MeetingTypeChannel:
      type: string
      enum:
        - local
        - local-attendee
        - google
        - zoom
        - phone
        - phone-incoming
        - whatsapp
        - connect
        - webex
        - skypeForConsumer
        - skypeForBusiness
        - teamsForBusiness
        - teamsForBusiness2
        - teamsForExchange
        - teams2ForExchange
        - custom
        - resource
        - whereby
        - kmeet
        - zava
        - jitsi
      description: Meeting channel/location type
    ConfirmationButton:
      type: object
      properties:
        useConfirmationButton:
          type: boolean
        text:
          type: string
        color:
          type: string
        link:
          type: string
      required:
        - useConfirmationButton
        - text
        - color
        - link
  securitySchemes:
    ApiUserHeader:
      type: apiKey
      in: header
      name: x-meetergo-api-user-id
      description: >-
        User ID to act on behalf of. Platform API Keys only (required with an
        API Key unless the endpoint states otherwise). Requests authenticated
        with a Personal Access Token are rejected if this header names another
        user.
    JWT:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: JWT Bearer token for standard user authentication
    ApiKey:
      scheme: bearer
      bearerFormat: API Key
      type: http
      description: >-
        Bearer token: a Platform API Key (format: ak_live:<uuid>:<secret>) or a
        Personal Access Token (format: rgo-...). PATs always act as the token
        owner.

````