Skip to main content

teams callrecord list

Lists all Teams calls within the tenant

Usage​

m365 teams callrecord list [options]

Options​

--userId [userId]

Filters call records to only include those where the user participated. Use the Entra user ID of the user. Specify either userId or userName but not both.

--userName [userName]

Filters call records to only include those where the user participated. Use the UPN of the user. Specify either userId or userName but not both.

--startDateTime [startDateTime]

Only show calls that started after this time. Defaults to 30 days ago.

--endDateTime [endDateTime]

Only show calls that started before this time (exclusive). Defaults to now.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, permissions, 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​

info

This command only supports application permissions. Use scope CallRecords.Read.All.

note

It is only possible to retrieve call records from the past 30 days.

Examples​

Get all call records from the past 30 days.

m365 teams callrecord list

Get all call records where a specific user participated in.

m365 teams callrecord list --userName "john.doe@contoso.com"

Get all call records that started within a specific timeframe.

m365 teams callrecord list --startDateTime "2025-05-1T00:00:00Z" --endDateTime "2025-05-14T00:00:00Z"

Response​

[
  {
    "id": "145ae53b-7781-47c4-a5f7-b0e043012624",
    "version": 1,
    "type": "peerToPeer",
    "modalities": [
      "audio"
    ],
    "lastModifiedDateTime": "2025-05-29T17:41:33.5066667Z",
    "startDateTime": "2025-05-29T17:27:20.428943Z",
    "endDateTime": "2025-05-29T17:37:20.428943Z",
    "joinWebUrl": "",
    "organizer": {
      "acsUser": null,
      "spoolUser": null,
      "phone": null,
      "guest": null,
      "encrypted": null,
      "onPremises": null,
      "acsApplicationInstance": null,
      "spoolApplicationInstance": null,
      "applicationInstance": null,
      "application": null,
      "device": null,
      "user": {
        "id": "b51efc8b-0adf-486c-ba54-b239ffa7c1f9",
        "displayName": "John Doe",
        "tenantId": "de5e90f2-9a07-4ed1-b903-f801afa7b1fd"
      }
    },
    "participants": [],
    "organizer_v2": {
      "id": "b51efc8b-0adf-486c-ba54-b239ffa7c1f9",
      "identity": {
        "endpointType": null,
        "acsUser": null,
        "spoolUser": null,
        "phone": null,
        "guest": null,
        "encrypted": null,
        "onPremises": null,
        "acsApplicationInstance": null,
        "spoolApplicationInstance": null,
        "applicationInstance": null,
        "application": null,
        "device": null,
        "azureCommunicationServicesUser": null,
        "assertedIdentity": null,
        "user": {
          "id": "b51efc8b-0adf-486c-ba54-b239ffa7c1f9",
          "displayName": "John Doe",
          "tenantId": "de5e90f2-9a07-4ed1-b903-f801afa7b1fd",
          "userPrincipalName": "john.doe@contoso.com"
        }
      },
      "administrativeUnitInfos": []
    }
  }
]