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

# List meetings

> Retrieve a paginated list of meetings. Supports various filters including company, event type, status, and date range.



## OpenAPI

````yaml /openapi.json get /api/public/v1/calendar/meetings
openapi: 3.0.3
info:
  title: MSPortal Public API
  version: 1.0.0
  description: >-
    Public API for MSPortal - provides programmatic access to tenant data.


    ## Authentication


    All endpoints require authentication via API key passed as a Bearer token:


    ```

    Authorization: Bearer <your-api-key>

    ```


    API keys can be created in the MSPortal dashboard under Settings →
    Integrations → API Access.


    **Important:** Do not include cookies in API requests. The public API uses
    stateless authentication only.


    ## Scopes


    API keys are granted specific scopes that determine what operations they can
    perform. Each endpoint documents its required scope(s).


    ## Rate Limiting


    API calls are rate limited per API key. Rate limit information is returned
    in response headers:


    - `X-RateLimit-Limit`: Maximum requests per minute

    - `X-RateLimit-Remaining`: Remaining requests in current window

    - `X-RateLimit-Reset`: When the rate limit resets (ISO 8601)


    ## Request ID


    All responses include an `X-Request-Id` header for debugging and support.
    You can also pass your own `X-Request-Id` header to correlate requests.
  contact:
    name: MSPortal Support
    email: support@msportal.ai
  license:
    name: Proprietary
servers:
  - url: https://app.msportal.ai
    description: Production environment
security:
  - BearerAuth: []
tags:
  - name: Budgets
    description: >-
      Budget management - create, track, and forecast budgets with line items,
      categories, and products
  - name: Calendar
    description: Calendar and meeting management - events, participants, and meeting types
  - name: Companies
    description: Company management endpoints
  - name: Company Users
    description: Company user management - client portal contacts (read-only, paginated)
  - name: Compliance
    description: Compliance check management - runs, assigned checks, and status updates
  - name: Dashboards
    description: Dashboard management - external iframe resources and internal dashboards
  - name: Devices
    description: Device management - inventory, types, and locations
  - name: Goals
    description: Goal management - create, track, and manage goals with tasks and updates
  - name: NPS Surveys
    description: >-
      NPS survey management - Net Promoter Score surveys, responses, and
      analytics
  - name: Reports
    description: >-
      Report management - create, manage, and schedule reports with templates
      and types
  - name: Planner
    description: >-
      Planner item management - tasks, roadmap items, and project planning with
      linked goals, compliance, and projects
  - name: Surveys
    description: >-
      General survey management - multi-question surveys, responses, and
      statistics
  - name: Tickets
    description: Ticket management - view and filter tickets from PSA integrations
  - name: Training
    description: >-
      Training management - courses, enrollments, certificates, and progress
      tracking
  - name: Users
    description: Tenant user management - internal staff and team members (read-only)
  - name: Automation Rules
    description: >-
      Automation rule management - create, configure, and monitor automation
      rules with triggers, conditions, and actions
  - name: Analytics
    description: >-
      Analytics and reporting - company audit data, training analytics, user
      activity, and portfolio metrics
paths:
  /api/public/v1/calendar/meetings:
    get:
      tags:
        - Calendar
      summary: List meetings
      description: >-
        Retrieve a paginated list of meetings. Supports various filters
        including company, event type, status, and date range.
      parameters:
        - schema:
            type: number
            minimum: 1
            default: 1
            description: Page number
          required: false
          description: Page number
          name: page
          in: query
        - schema:
            type: number
            minimum: 1
            maximum: 100
            default: 25
            description: Items per page
          required: false
          description: Items per page
          name: limit
          in: query
        - schema:
            type: string
            enum:
              - start_time
              - created_at
              - title
              - status
            default: start_time
            description: Field to sort by
          required: false
          description: Field to sort by
          name: sortBy
          in: query
        - schema:
            type: boolean
            nullable: true
            default: true
            description: Sort descending
          required: false
          description: Sort descending
          name: sortDesc
          in: query
        - schema:
            type: string
            format: uuid
            description: Filter by company ID
          required: false
          description: Filter by company ID
          name: companyId
          in: query
        - schema:
            type: string
            enum:
              - QBR
              - OnSiteTechVisit
              - InternalMeeting
              - ClientCall
              - ProjectMilestone
              - ComplianceReview
              - BusinessReview
              - Other
            description: Filter by event type
          required: false
          description: Filter by event type
          name: eventType
          in: query
        - schema:
            type: string
            enum:
              - Scheduled
              - Confirmed
              - Completed
              - Canceled
              - Rescheduled
              - Pending Notes
            description: Filter by status
          required: false
          description: Filter by status
          name: status
          in: query
        - schema:
            type: string
            format: date-time
            description: Filter by start date (from)
          required: false
          description: Filter by start date (from)
          name: startDateFrom
          in: query
        - schema:
            type: string
            format: date-time
            description: Filter by start date (to)
          required: false
          description: Filter by start date (to)
          name: startDateTo
          in: query
        - schema:
            type: string
            format: uuid
            description: Filter by creator user ID
          required: false
          description: Filter by creator user ID
          name: createdById
          in: query
      responses:
        '200':
          description: List of meetings
          headers:
            X-RateLimit-Limit:
              schema:
                type: integer
              description: Rate limit ceiling
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: Remaining requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MeetingListResponse'
        '400':
          description: Invalid query parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden - Missing required scope (calendar.read)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    MeetingListResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Meeting'
          description: Array of meetings
        pagination:
          $ref: '#/components/schemas/Pagination'
      required:
        - data
        - pagination
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Error message
        requestId:
          type: string
          description: Request correlation ID
        details:
          nullable: true
          description: Additional error details
        code:
          type: string
          description: Error code
      required:
        - error
    Meeting:
      type: object
      properties:
        id:
          type: string
          description: Unique meeting identifier
        title:
          type: string
          description: Meeting title
        startTime:
          type: string
          format: date-time
          description: Meeting start time (ISO 8601)
        endTime:
          type: string
          format: date-time
          description: Meeting end time (ISO 8601)
        isAllDay:
          type: boolean
          description: Whether this is an all-day event
        companyId:
          type: string
          nullable: true
          description: Associated company ID
        companyName:
          type: string
          nullable: true
          description: Associated company name
        eventType:
          type: string
          description: >-
            Event type (QBR, OnSiteTechVisit, InternalMeeting, ClientCall,
            ProjectMilestone, ComplianceReview, BusinessReview, Other)
        status:
          type: string
          description: >-
            Meeting status (Scheduled, Confirmed, Completed, Canceled,
            Rescheduled, Pending Notes)
        locationId:
          type: string
          nullable: true
          description: Location ID
        locationName:
          type: string
          nullable: true
          description: Location name
        locationText:
          type: string
          nullable: true
          description: Location description/address
        createdById:
          type: string
          nullable: true
          description: Creator user ID
        createdByName:
          type: string
          nullable: true
          description: Creator name
        recurrenceRule:
          type: string
          nullable: true
          description: iCal recurrence rule (RRULE)
        meetingSource:
          type: string
          nullable: true
          description: Meeting source (internal or external)
        externalEventId:
          type: string
          nullable: true
          description: External calendar event ID
        createdAt:
          type: string
          format: date-time
          description: Creation timestamp (ISO 8601)
        updatedAt:
          type: string
          nullable: true
          format: date-time
          description: Last update timestamp (ISO 8601)
      required:
        - id
        - title
        - startTime
        - endTime
        - isAllDay
        - companyId
        - companyName
        - eventType
        - status
        - locationId
        - locationName
        - locationText
        - createdById
        - createdByName
        - recurrenceRule
        - meetingSource
        - externalEventId
        - createdAt
        - updatedAt
    Pagination:
      type: object
      properties:
        page:
          type: integer
          minimum: 1
          description: Current page number
        limit:
          type: integer
          minimum: 1
          maximum: 100
          description: Items per page
        totalCount:
          type: integer
          description: Total number of items
        totalPages:
          type: integer
          description: Total number of pages
        hasNextPage:
          type: boolean
          description: Whether there is a next page
        hasPrevPage:
          type: boolean
          description: Whether there is a previous page
      required:
        - page
        - limit
        - totalCount
        - totalPages
        - hasNextPage
        - hasPrevPage
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Use your API key as a Bearer token. API keys can be generated in
        Settings → Integrations → API Access.

````