Skip to main content

teams report pstncalls

Get details about PSTN calls made within a given time period

Usage​

m365 teams report pstncalls [options]

Options​

--fromDateTime <fromDateTime>

The start of time range to query. UTC, inclusive.

--toDateTime [toDateTime]

The end time range to query. UTC, inclusive. Defaults to today if omitted.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

This command only works with app-only permissions. You will need to create your own Microsoft Entra app with CallRecords.Read.All permission assigned. Instructions on how to create your own Microsoft Entra app can be found at Using your own Microsoft Entra identity

The difference between fromDateTime and toDateTime cannot exceed a period of 90 days.

info

This command supports only csv and json output.

Examples​

Get details about PSTN calls made between 2020-10-31 and today.

m365 teams report pstncalls --fromDateTime 2020-10-31

Get details about PSTN calls made between 2020-10-31 and 2020-12-31 and exports the report data in the specified path in text format.

m365 teams report pstncalls --fromDateTime 2020-10-31 --toDateTime 2020-12-31 --output text > "pstncalls.txt"

Get details about PSTN calls made between 2020-10-31 and 2020-12-31 and exports the report data in the specified path in json format.

m365 teams report pstncalls --fromDateTime 2020-10-31 --toDateTime 2020-12-31 --output json > "pstncalls.json"

More information​

Response​

{
  "@odata.count": 1,
  "value": [
    {
      "id": "9c4984c7-6c3c-427d-a30c-bd0b2eacee90",
      "callId": "1835317186_112562680@61.221.3.176",
      "userId": "db03c14b-06eb-4189-939b-7cbf3a20ba27",
      "userPrincipalName": "richard.malk@contoso.com",
      "userDisplayName": "Richard Malk",
      "startDateTime": "2019-11-01T00:00:08.2589935Z",
      "endDateTime": "2019-11-01T00:03:47.2589935Z",
      "duration": 219,
      "charge": 0.00,
      "callType": "user_in",
      "currency": "USD",
      "calleeNumber": "+1234567890",
      "usageCountryCode": "US",
      "tenantCountryCode": "US",
      "connectionCharge": 0.00,
      "callerNumber": "+0123456789",
      "destinationContext": null,
      "destinationName": "United States",
      "conferenceId": null,
      "licenseCapability": "MCOPSTNU",
      "inventoryType": "Subscriber"
    }
  ]
}
CTRL + M