Get Call Record

Get Call Record

Retrieve a specific call record by its identifier from the Microsoft Teams API.

API Details

• API Name: Microsoft Teams API
• OpenAPI Ref: ../​../​openapi/​microsoft-teams-openapi.yaml
• Endpoint: GET /​communications/​callRecords/​{callRecord-id}
• Operation ID: getCallRecord
• Tag: CallRecords

Sandbox

• Base URL: http://localhost:8080/rest/microsoft-teams-api/1.0.0
• Full URL: http://localhost:8080/rest/microsoft-teams-api/1.0.0/communications/callRecords/{callRecord-id}

Required Headers

• Content-Type: application/​json
• Authorization: Bearer {access_token}

OAuth Scopes

• CallRecords.Read.All

Parameters

Path Parameters

Query Parameters

Example Request

curl -X GET \
  "http://localhost:8080/rest/microsoft-teams-api/1.0.0/communications/callRecords/callrecord-001?$expand=sessions" \
  -H "Content-Type: application/​json" \
  -H "Authorization: Bearer {access_token}"

Example Response

{
  "id": "callrecord-001",
  "version": 1,
  "type": "peerToPeer",
  "modalities": [
    "audio"
  ],
  "startDateTime": "2025-01-20T14:00:00Z",
  "endDateTime": "2025-01-20T14:30:00Z",
  "organizer": {
    "user": {
      "id": "user-001",
      "displayName": "Jane Smith"
    }
  }
}

Instructions

1. Obtain a valid access token with the CallRecords.Read.All scope.
2. Identify the call record by its callRecord-id.
3. Optionally use the $expand query parameter to include related entities such as sessions.
4. Send the GET request to the callRecord endpoint.
5. The response contains the call record details including type, modalities, timestamps, and organizer information.