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.