callRecord resource type
Namespace: microsoft.graph.callRecords
Important
APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Represents a single peer-to-peer call or a group call between multiple participants, sometimes referred to as an online meeting. A call record is created after a call or meeting ends.
Methods
| Method | Return Type | Description |
|---|---|---|
| List | microsoft.graph.callRecords.callRecord collection | Get the list of callRecord objects and their properties. |
| Get | microsoft.graph.callRecords.callRecord | Read the properties and relationships of a callRecord object. |
| Get PSTN calls | microsoft.graph.callRecords.pstnCallLogRow collection | List pstnCallLogRow objects in a call record. |
| List direct routing calls | microsoft.graph.callRecords.directRoutingLogRow collection | List directRoutingLogRow objects for a call record. |
| Get PSTN blocked users log | microsoft.graph.callRecords.pstnBlockedUsersLogRow collection | Get the log of users who are blocked/unblocked from making public switched telephone network (PSTN) calls in Microsoft Teams as a collection of pstnBlockedUsersLogRow entries. |
| Get PSTN online meeting dial-out report | microsoft.graph.callRecords.pstnOnlineMeetingDialoutReport collection | Get aggregated report of the usage and money spent for the audio conferencing dial-out service as a collection of pstnOnlineMeetingDialoutReport entries. |
| Get SMS log | microsoft.graph.callRecords.smsLogRow collection | Get the log of a sent/received SMS as a collection of smsLogRow entries. |
Properties
| Property | Type | Description |
|---|---|---|
| endDateTime | DateTimeOffset | UTC time when the last user left the call. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z |
| id | String | Unique identifier for the call record. Read-only. |
| joinWebUrl | String | Meeting URL associated to the call. May not be available for a peerToPeer call record type. |
| lastModifiedDateTime | DateTimeOffset | UTC time when the call record was created. The DatetimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z |
| modalities | modality collection | List of all the modalities used in the call. Possible values are: unknown, audio, video, videoBasedScreenSharing, data, screenSharing, unknownFutureValue. |
| startDateTime | DateTimeOffset | UTC time when the first user joined the call. The DatetimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z |
| type | callType | Indicates the type of the call. Possible values are: unknown, groupCall, peerToPeer, unknownFutureValue. |
| version | Int64 | Monotonically increasing version of the call record. Higher version call records with the same ID include additional data compared to the lower version. |
| organizer (deprecated) | identitySet | The organizing party's identity. The organizer property is deprecated and will stop returning data on June 30, 2026. Going forward, use the organizer_v2 relationship. |
| participants (deprecated) | identitySet collection | List of distinct identities involved in the call. Limited to 130 entries. The participants property is deprecated and will stop returning data on June 30, 2026. Going forward, use the participants_v2 relationship. |
Relationships
| Relationship | Type | Description |
|---|---|---|
| organizer_v2 | microsoft.graph.callRecords.organizer | Identity of the organizer of the call. This relationship is expanded by default in callRecord methods. |
| participants_v2 | microsoft.graph.callRecords.participant collection | List of distinct participants in the call. |
| sessions | microsoft.graph.callRecords.session collection | List of sessions involved in the call. Peer-to-peer calls typically only have one session, whereas group calls typically have at least one session per participant. Read-only. Nullable. |
JSON representation
The following JSON representation shows the resource type.
{
"endDateTime": "String (timestamp)",
"id": "String (identifier)",
"joinWebUrl": "String",
"lastModifiedDateTime": "String (timestamp)",
"modalities": ["string"],
"organizer": {"@odata.type": "microsoft.graph.identitySet"},
"participants": [{"@odata.type": "microsoft.graph.identitySet"}],
"startDateTime": "String (timestamp)",
"type": "String",
"version": "Int64"
}