Get Call

Retrieve call details from the Microsoft Teams API using a call ID.

Updated Feb 19, 2026
One-click install
npx skills add https://github.com/naftiko/microsoft-teams-sandbox --skill get-call
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Get Call
Source: https://github.com/naftiko/microsoft-teams-sandbox/tree/main/skills/get-call
Command: npx skills add https://github.com/naftiko/microsoft-teams-sandbox --skill get-call

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill allows users to retrieve specific details about an ongoing or completed call within Microsoft Teams, enabling better call management and auditing.

Core Features & Use Cases

  • Call Information Retrieval: Fetches details such as call state, direction, and associated tenant ID.
  • Use Case: A support agent needs to quickly check the status and details of a customer's recent call to assist with an inquiry.

Quick Start

Use the get call skill to retrieve the details for the call with ID 'call-001'.

Frequently Asked Questions about Get Call

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I retrieve Microsoft Teams call details for auditing?

You can retrieve Microsoft Teams call details by providing a valid call ID to query the communications API. This fetches call state, direction, and tenant ID data for auditing and operational monitoring.

What information is returned when I retrieve Microsoft Teams call data?

Retrieving Microsoft Teams call data returns specific details including the call state, direction, and associated tenant ID. This information supports real-time or historical call management and support inquiries.

What access token scope is required to fetch Microsoft Teams call details?

Fetching Microsoft Teams call details requires an access token with the Calls.Initiate.All scope. You must provide this token along with a valid call ID to authenticate your communications API query.

Can I use a call ID to check the status of an ongoing Microsoft Teams call?

Yes, you can use a valid call ID to check the status of an ongoing Microsoft Teams call. The retrieval process fetches real-time call state and direction data for active communications.

What are the limitations when retrieving Microsoft Teams call history?

Retrieving Microsoft Teams call history requires a valid call ID and an access token with the Calls.Initiate.All scope. Without these prerequisites, the communications API cannot process the call details query.