Show / Hide Table of Contents

CallRecord-PstnCalls.Read.All

Allows the app to read all PSTN and direct routing call log data without a signed-in user.

Graph Methods

Type: A = Application Permission, D = Delegate Permission

Ver Type Method
V1 A GET /communications/callRecords/getDirectRoutingCalls
V1 A GET /communications/callRecords/getPstnCalls

Application Permission

Id a2611786-80b3-417e-adaa-707d4261a5f0
Display String Read PSTN and direct routing call log data
Description Allows the app to read all PSTN and direct routing call log data without a signed-in user.

Resources

directRoutingLogRow

Property Type Description
callEndSubReason Int32 In addition to the SIP codes, Microsoft has own subcodes that indicate the specific issue.
callType String Call type and direction.
calleeNumber String Number of the user or bot who received the call. E.164 format, but may include additional data.
callerNumber String Number of the user or bot who made the call. E.164 format, but may include additional data.
correlationId String Identifier for the call that you can use when calling Microsoft Support. GUID.
duration Int32 Duration of the call in seconds.
endDateTime DateTimeOffset Only exists for successful (fully established) calls. Time when call ended.
failureDateTime DateTimeOffset Only exists for failed (not fully established) calls.
finalSipCodePhrase String Description of the SIP code and Microsoft subcode.
finalSipCode Int32 The code with which the call ended, RFC 3261.
id String Unique call identifier. GUID.
inviteDateTime DateTimeOffset When the initial invite was sent.
mediaBypassEnabled Boolean Indicates if the trunk was enabled for media bypass or not.
mediaPathLocation String The datacenter used for media path in non-bypass call.
signalingLocation String The datacenter used for signaling for both bypass and non-bypass calls.
startDateTime DateTimeOffset Call start time.
For failed and unanswered calls, this can be equal to invite or failure time.
successfulCall Boolean Success or attempt.
trunkFullyQualifiedDomainName String Fully qualified domain name of the session border controller.
userDisplayName String Display name of the user.
userId String Calling user's ID in Graph. This and other user info will be null/empty for bot call types. GUID.
userPrincipalName String UserPrincipalName (sign-in name) in Azure Active Directory. This is usually the same as user's SIP Address, and can be same as user's e-mail address.

pstnCallLogRow

Property Type Description
callDurationSource microsoft.graph.callRecords.pstnCallDurationSource The source of the call duration data. If the call uses a third-party telecommunications operator via the Operator Connect Program, the operator may provide their own call duration data. In this case, the property value is operator. Otherwise, the value is microsoft.
calleeNumber String Number dialed in E.164 format.
callerNumber String Number that received the call for inbound calls or the number dialed for outbound calls. E.164 format.
callId String Call identifier. Not guaranteed to be unique.
callType String Whether the call was a PSTN outbound or inbound call and the type of call such as a call placed by a user or an audio conference.
charge Double Amount of money or cost of the call that is charged to your account.
conferenceId String ID of the audio conference.
connectionCharge Double Connection fee price.
currency String Type of currency used to calculate the cost of the call (ISO 4217).
destinationContext String Whether the call was domestic (within a country or region) or international (outside a country or region) based on the user's location.
destinationName String Country or region dialed.
duration Int32 How long the call was connected, in seconds.
endDateTime DateTimeOffset Call end time.
id String Unique call identifier. GUID.
inventoryType String User's phone number type, such as a service of toll-free number.
licenseCapability String The license used for the call.
operator String The telecommunications operator which provided PSTN services for this call. This may be Microsoft, or it may be a third-party operator via the Operator Connect Program.
startDateTime DateTimeOffset Call start time.
tenantCountryCode String Country code of the tenant, ISO 3166-1 alpha-2.
usageCountryCode String Country code of the user, ISO 3166-1 alpha-2.
userDisplayName String Display name of the user.
userId String Calling user's ID in Graph. GUID. This and other user info will be null/empty for bot call types (ucap_in, ucap_out).
userPrincipalName String UserPrincipalName (sign-in name) in Azure Active Directory. This is usually the same as user's SIP Address, and can be same as user's e-mail address.
In This Article
Back to top Created by merill | Submit feedback