ESC
Type to search...

OnlineMeetings.Read

Export JSON
Export CSV
Copy URL
Print
Delegated Read User Scope

Allows the app to read online meeting details on behalf of the signed-in user.

Permission data: April 6, 2026 at 4:06 AM UTC
Delegated Access App-Only Access

Permission Details

Delegated Permission User consent allowed

Read user's online meetings

Allows the app to read online meeting details on behalf of the signed-in user.

Properties

Microsoft Graph v1.0 mapped-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property Type Description
allowAttendeeToEnableCamera BooleanNullable Indicates whether attendees can turn on their camera. Inherited from onlineMeetingBase.
allowAttendeeToEnableMic BooleanNullable Indicates whether attendees can turn on their microphone. Inherited from onlineMeetingBase.
allowBreakoutRooms BooleanNullable Indicates whether breakout rooms are enabled for the meeting. Inherited from onlineMeetingBase.
allowCopyingAndSharingMeetingContent BooleanNullable Indicates whether the ability to copy and share meeting content is enabled for the meeting. Inherited from onlineMeetingBase.
allowedLobbyAdmitters allowedLobbyAdmitterRoles Specifies the users who can admit from the lobby. The possible values are: organizerAndCoOrganizersAndPresenters, organizerAndCoOrganizers, unknownFutureValue. Inherited from onlineMeetingBase.
allowedPresenters onlineMeetingPresenters Specifies who can be a presenter in a meeting. Possible values are listed in the following table. Inherited from onlineMeetingBase.
allowLiveShare meetingLiveShareOptions Indicates whether live share is enabled for the meeting. The possible values are: enabled, disabled, unknownFutureValue. Inherited from onlineMeetingBase.
allowMeetingChat meetingChatMode Specifies the mode of meeting chat. Inherited from onlineMeetingBase.
allowParticipantsToChangeName BooleanNullable Specifies if participants are allowed to rename themselves in an instance of the meeting. Inherited from onlineMeetingBase.
allowPowerPointSharing BooleanNullable Indicates whether PowerPoint live is enabled for the meeting. Inherited from onlineMeetingBase.
allowTeamworkReactions BooleanNullable Indicates whether Teams reactions are enabled for the meeting. Inherited from onlineMeetingBase.
allowRecording BooleanNullable Indicates whether recording is enabled for the meeting. Inherited from onlineMeetingBase.
allowTranscription BooleanNullable Indicates whether transcription is enabled for the meeting. Inherited from onlineMeetingBase.
allowWhiteboard BooleanNullable Indicates whether whiteboard is enabled for the meeting. Inherited from onlineMeetingBase.
audioConferencing audioConferencing The phone access (dial-in) information for an online meeting. Read-only. Inherited from onlineMeetingBase.

Showing 15 of 48 properties.

JSON Representation

Microsoft Graph v1.0 mapped-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation
{
  "allowAttendeeToEnableCamera": "Boolean",
  "allowAttendeeToEnableMic": "Boolean",
  "allowBreakoutRooms": "Boolean",
  "allowCopyingAndSharingMeetingContent": "Boolean",
  "allowedLobbyAdmitters": "String",
  "allowedPresenters": "String",
  "allowLiveShare": "String",
  "allowMeetingChat": "String",
  "allowParticipantsToChangeName": "Boolean",
  "allowPowerPointSharing": "Boolean",
  "allowRecording": "Boolean",
  "allowTeamworkReactions": "Boolean",
  "allowTranscription": "Boolean",
  "allowWhiteboard": "Boolean",
  "attendeeReport": "Stream",
  "audioConferencing": {
    "@odata.type": "microsoft.graph.audioConferencing"
  },
  "broadcastSettings": {
    "@odata.type": "microsoft.graph.broadcastMeetingSettings"
  },
  "chatInfo": {
    "@odata.type": "microsoft.graph.chatInfo"
  },
  "chatRestrictions": {
    "@odata.type": "microsoft.graph.chatRestrictions"
  },
  "creationDateTime": "String (timestamp)",
  "endDateTime": "String (timestamp)",
  "expiryDateTime": "String (timestamp)",
  "externalId": "String",
  "id": "String (identifier)",
  "isBroadcast": "Boolean",
  "isEndToEndEncryptionEnabled": "Boolean",
  "isEntryExitAnnounced": "Boolean",
  "joinInformation": {
    "@odata.type": "microsoft.graph.itemBody"
  },
  "joinMeetingIdSettings": {
    "@odata.type": "microsoft.graph.joinMeetingIdSettings"
  },
  "joinWebUrl": "String",
  "lobbyBypassSettings": {
    "@odata.type": "microsoft.graph.lobbyBypassSettings"
  },
  "meetingOptionsWebUrl": "String",
  "meetingSpokenLanguageTag": "String",
  "meetingTemplateId": "String",
  "participants": {
    "@odata.type": "microsoft.graph.meetingParticipants"
  },
  "recordAutomatically": "Boolean",
  "sensitivityLabelAssignment": {
    "@odata.type": "microsoft.graph.onlineMeetingSensitivityLabelAssignment"
  },
  "shareMeetingChatHistoryDefault": "String",
  "startDateTime": "String (timestamp)",
  "subject": "String",
  "videoTeleconferenceId": "String",
  "watermarkProtection": "String"
}

Relationships

Microsoft Graph v1.0 mapped-docs

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship Type Description
attendanceReports meetingAttendanceReport collection The attendance reports of an online meeting. Read-only. Inherited from onlineMeetingBase.
recordings callRecording collection The recordings of an online meeting. Read-only.
transcripts callTranscript collection The transcripts of an online meeting. Read-only.
aiInsights callAiInsight collection The AI insights generated for an online meeting. Read-only.
anonymizeIdentityForRoles array Specifies whose identity is anonymized in the meeting. The possible values are: attendee. The attendee value can't be removed through a PATCH operation once added.
capabilities array The list of meeting capabilities. The possible values are: questionAndAnswer,unknownFutureValue.

Graph Methods

Delegated access App-only access
Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /communications/onlineMeetings/?$filter=VideoTeleconferenceId%20eq%20'{videoTeleconferenceId}'
GET /me/onlineMeetings?$filter=joinMeetingIdSettings/joinMeetingId%20eq%20'{joinMeetingId}'
GET /me/onlineMeetings?$filter=JoinWebUrl%20eq%20'{joinWebUrl}'
GET /me/onlineMeetings/{meetingId}
GET /me/onlineMeetings/{meetingId}/alternativeRecording
GET /me/onlineMeetings/{meetingId}/attendeeReport
GET /me/onlineMeetings/{meetingId}/recording
GET /me/onlineMeetings/{onlineMeetingId}/getVirtualAppointmentJoinWebUrl
GET /users/{userId}/onlineMeetings?$filter=joinMeetingIdSettings/joinMeetingId%20eq%20'{joinMeetingId}'
GET /users/{userId}/onlineMeetings?$filter=JoinWebUrl%20eq%20'{joinWebUrl}'
GET /users/{userId}/onlineMeetings/{meetingId}
GET /users/{userId}/onlineMeetings/{meetingId}/alternativeRecording
GET /users/{userId}/onlineMeetings/{meetingId}/attendeeReport
GET /users/{userId}/onlineMeetings/{meetingId}/recording
GET /users/{userId}/onlineMeetings/{onlineMeetingId}/getVirtualAppointmentJoinWebUrl
Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /app/onlineMeetings/?$filter=VideoTeleconferenceId%20eq%20'{videoTeleconferenceId}'
GET /communications/onlineMeetings/?$filter=VideoTeleconferenceId%20eq%20'{videoTeleconferenceId}'
GET /me/onlineMeetings?$filter=joinMeetingIdSettings/joinMeetingId%20eq%20'{joinMeetingId}'
GET /me/onlineMeetings?$filter=JoinWebUrl%20eq%20'{joinWebUrl}'
GET /me/onlineMeetings/{id}/registration
GET /me/onlineMeetings/{id}/registration/microsoft.graph.meetingRegistration/customQuestions
GET /me/onlineMeetings/{id}/registration/registrants
GET /me/onlineMeetings/{meetingId}
GET /me/onlineMeetings/{meetingId}/alternativeRecording
GET /me/onlineMeetings/{meetingId}/attendeeReport
GET /me/onlineMeetings/{meetingId}/recording
GET /me/onlineMeetings/{meetingId}/registration
GET /me/onlineMeetings/{meetingId}/registration/customQuestions/{id}
GET /me/onlineMeetings/{meetingId}/registration/registrants
GET /me/onlineMeetings/{onlineMeetingId}/getVirtualAppointmentJoinWebUrl
GET /me/onlineMeetings/{onlineMeetingId}/virtualAppointment
GET /users/{userId}/onlineMeetings?$filter=joinMeetingIdSettings/joinMeetingId%20eq%20'{joinMeetingId}'
GET /users/{userId}/onlineMeetings?$filter=JoinWebUrl%20eq%20'{joinWebUrl}'
GET /users/{userId}/onlineMeetings/{meetingId}
GET /users/{userId}/onlineMeetings/{meetingId}/alternativeRecording
GET /users/{userId}/onlineMeetings/{meetingId}/attendeeReport
GET /users/{userId}/onlineMeetings/{meetingId}/recording
GET /users/{userId}/onlineMeetings/{meetingId}/registration
GET /users/{userId}/onlineMeetings/{meetingId}/registration/registrants
GET /users/{userId}/onlineMeetings/{onlineMeetingId}/getVirtualAppointmentJoinWebUrl
GET /users/{userId}/onlineMeetings/{onlineMeetingId}/virtualAppointment
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
Get-MgCommunicationOnlineMeeting /me/onlineMeetings/{meetingId}
Get onlineMeeting
Get-MgUserOnlineMeeting /me/onlineMeetings/{meetingId}
Get onlineMeeting
Get-MgUserOnlineMeetingAttendeeReport /me/onlineMeetings/{meetingId}
Get onlineMeeting
Get-MgUserOnlineMeetingVirtualAppointmentJoinWebUrl /me/onlineMeetings/{onlineMeetingId}/getVirtualAppointmentJoinWebUrl
virtualAppointment: getVirtualAppointmentJoinWebUrl
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
Get-MgBetaCommunicationOnlineMeeting /me/onlineMeetings/{meetingId}
Get onlineMeeting
Get-MgBetaUserOnlineMeeting /me/onlineMeetings/{meetingId}
Get onlineMeeting
Get-MgBetaUserOnlineMeetingAttendeeReport /me/onlineMeetings/{meetingId}
Get onlineMeeting
Get-MgBetaUserOnlineMeetingRecording /me/onlineMeetings/{meetingId}
Get onlineMeeting
Get-MgBetaUserOnlineMeetingRegistration /me/onlineMeetings/{id}/registration
Get meetingRegistration
Get-MgBetaUserOnlineMeetingRegistration /me/onlineMeetings/{meetingId}/registration
Get externalMeetingRegistration
Get-MgBetaUserOnlineMeetingRegistrationCustomQuestion /me/onlineMeetings/{meetingId}/registration/customQuestions/{id}
Get customRegistrationQuestion
Get-MgBetaUserOnlineMeetingRegistrationRegistrant /me/onlineMeetings/{id}/registration/registrants
List registrants
Get-MgBetaUserOnlineMeetingRegistrationRegistrant /me/onlineMeetings/{meetingId}/registration/registrants
List externalMeetingRegistrants
Get-MgBetaUserOnlineMeetingVirtualAppointmentJoinWebUrl /me/onlineMeetings/{onlineMeetingId}/getVirtualAppointmentJoinWebUrl
virtualAppointment: getVirtualAppointmentJoinWebUrl

Code Examples

C# / .NET SDK
Get onlineMeeting
// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Communications.OnlineMeetings.GetAsync((requestConfiguration) =>
{
	requestConfiguration.QueryParameters.Filter = "VideoTeleconferenceId eq '123456789'";
});
JavaScript
Get onlineMeeting
const options = {
	authProvider,
};

const client = Client.init(options);

let onlineMeetings = await client.api('/communications/onlineMeetings/')
	.filter('VideoTeleconferenceId eq \'123456789\'')
	.get();
PowerShell
Get onlineMeeting
Import-Module Microsoft.Graph.CloudCommunications

Get-MgCommunicationOnlineMeeting -Filter "VideoTeleconferenceId eq '123456789'"
Python
Get onlineMeeting
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.communications.online_meetings.online_meetings_request_builder import OnlineMeetingsRequestBuilder
from kiota_abstractions.base_request_configuration import RequestConfiguration
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
query_params = OnlineMeetingsRequestBuilder.OnlineMeetingsRequestBuilderGetQueryParameters(
		filter = "VideoTeleconferenceId eq '123456789'",
)

request_configuration = RequestConfiguration(
query_parameters = query_params,
)

result = await graph_client.communications.online_meetings.get(request_configuration = request_configuration)

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Delegated permissions and search for OnlineMeetings.Read

4

Grant Admin Consent

Users can consent to this permission during sign-in.