pstnCallLogRow resource type

Namespace: microsoft.graph.callRecords

Represents a row of data in the public switched telephone network (PSTN) call log. Each row maps to one call.


Method Return Type Description
getPstnCalls microsoft.graph.callRecords.pstnCallLogRow collection List pstnCallLogRow objects in a call record.


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 can 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 Indicates 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. For details, see (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 might be Microsoft, or it might be a third-party operator via the Operator Connect Program.
startDateTime DateTimeOffset Call start time.
tenantCountryCode String Country code of the tenant. For details, see ISO 3166-1 alpha-2.
usageCountryCode String Country code of the user. For details, see ISO 3166-1 alpha-2.
userDisplayName String Display name of the user.
userId String Calling user's ID in Microsoft Graph. GUID. This and other user info will be null/empty for bot call types (ucap_in, ucap_out).
userPrincipalName String The user principal name (sign-in name) in Microsoft Entra ID. This is usually the same as the user's SIP address, and can be the same as the user's email address.



JSON representation

The following JSON representation shows the resource type.

  "@odata.type": "#microsoft.graph.callRecords.pstnCallLogRow",
  "callDurationSource": "String",
  "calleeNumber": "String",
  "callId": "String",
  "callerNumber": "String",
  "callType": "String",
  "charge": "Double",
  "connectionCharge": "Double",
  "conferenceId": "String",
  "currency": "String",
  "destinationContext": "String",
  "destinationName": "String",
  "duration": "Integer",
  "endDateTime": "String (timestamp)",
  "id": "String (identifier)",
  "inventoryType": "String",
  "licenseCapability": "String",
  "operator": "String",
  "startDateTime": "String (timestamp)",
  "tenantCountryCode": "String",
  "usageCountryCode": "String",
  "userDisplayName": "String",
  "userId": "String",
  "userPrincipalName": "String"