CopilotCostManagement-Reports.Read.All
Allows the app to read the organization's aggregate Copilot cost data without a signed-in user, including its credit balance and usage and spending reports. It can also check Copilot cost export job status and download completed exports, which may contain full report details. This permission is separate from Reports.Read.All for Microsoft 365 Copilot usage reporting.
In short
CopilotCostManagement-Reports.Read.All is available as both an application permission and a delegated permission in the Microsoft Graph API, grouped under the CopilotCostManagement-Reports category. Allows the app to read the organization's aggregate Copilot cost data without a signed-in user, including its credit balance and usage and spending reports. It can also check Copilot cost export job status and download completed exports, which may contain full report details. This permission is separate from Reports.Read.All for Microsoft 365 Copilot usage reporting. It grants full control over resources. Application permissions always require admin consent.
Permission Details
Read Copilot cost reports and export results
Allows the app to read the organization's aggregate Copilot cost data without a signed-in user, including its credit balance and usage and spending reports. It can also check Copilot cost export job status and download completed exports, which may contain full report details. This permission is separate from Reports.Read.All for Microsoft 365 Copilot usage reporting.
ec42fb68-397f-40ab-baa1-c8d0b745a680
Read Copilot cost reports and export results
Allows the app to read the organization's aggregate Copilot cost data on behalf of the signed-in user, including its credit balance and usage and spending reports. It can also check Copilot cost export job status and download completed exports, which may contain full report details. This permission is separate from Reports.Read.All for Microsoft 365 Copilot usage reporting.
db3b53cd-01a9-45db-8f48-b97de4e9e8ff
Properties
Properties metadata is not available for this permission mapping. View on Microsoft Learn
JSON Representation
JSON representation is not available for this permission mapping. View on Microsoft Learn
Relationships
Relationships metadata is not available for this permission mapping.
View resource documentationGraph Methods
Microsoft Graph v1.0 endpoints are not available from refreshed Microsoft Learn or Microsoft Graph OpenAPI metadata for this permission.
No API methods available for this version.
Microsoft Graph beta endpoints are not available from refreshed Microsoft Learn or Microsoft Graph OpenAPI metadata for this permission.
No API methods available for this version.
Microsoft Graph PowerShell v1.0 commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.
No deterministic PowerShell command map is available for this permission.
Browse PowerShell docsMicrosoft Graph PowerShell beta commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.
No deterministic PowerShell command map is available for this permission.
Browse PowerShell docsCode Examples
using Azure.Identity;
using Microsoft.Graph;
var scopes = new[] { "CopilotCostManagement-Reports.Read.All" };
var credential = new InteractiveBrowserCredential(
new InteractiveBrowserCredentialOptions
{
ClientId = "YOUR_CLIENT_ID",
TenantId = "YOUR_TENANT_ID",
RedirectUri = new Uri("http://localhost")
});
var graphClient = new GraphServiceClient(credential, scopes);
var response = await graphClient
.WithUrl("https://graph.microsoft.com/v1.0/copilotcostmanagement-reports")
.GetAsync();
import { Client } from "@microsoft/microsoft-graph-client";
import { InteractiveBrowserCredential } from "@azure/identity";
const credential = new InteractiveBrowserCredential({
clientId: "YOUR_CLIENT_ID",
tenantId: "YOUR_TENANT_ID",
redirectUri: "http://localhost"
});
const token = await credential.getToken(["CopilotCostManagement-Reports.Read.All"]);
const client = Client.init({
authProvider: (done) => done(null, token.token)
});
const response = await client.api("/copilotcostmanagement-reports").get();
Connect-MgGraph -Scopes "CopilotCostManagement-Reports.Read.All"
Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/copilotcostmanagement-reports"
from azure.identity import InteractiveBrowserCredential
import requests
credential = InteractiveBrowserCredential(
client_id="YOUR_CLIENT_ID",
tenant_id="YOUR_TENANT_ID"
)
token = credential.get_token("CopilotCostManagement-Reports.Read.All")
response = requests.get(
"https://graph.microsoft.com/v1.0/copilotcostmanagement-reports",
headers={"Authorization": f"Bearer {token.token}"}
)
print(response.json())
App Registration
Navigate to Azure Portal
Go to App registrations in Microsoft Entra admin center
Add API Permission
Select your app → API permissions → Add a permission → Microsoft Graph
Select Permission Type
Choose Application permissions or delegated permissions and search for CopilotCostManagement-Reports.Read.All
Grant Admin Consent
Application permissions always require admin consent.
Frequently asked questions
What is the CopilotCostManagement-Reports.Read.All Microsoft Graph permission?
CopilotCostManagement-Reports.Read.All is available as both an application permission and a delegated permission in the Microsoft Graph API, grouped under the CopilotCostManagement-Reports category. Allows the app to read the organization's aggregate Copilot cost data without a signed-in user, including its credit balance and usage and spending reports. It can also check Copilot cost export job status and download completed exports, which may contain full report details. This permission is separate from Reports.Read.All for Microsoft 365 Copilot usage reporting. It grants full control over resources. Application permissions always require admin consent. It is mapped to the Microsoft Graph copilotcostmanagement-reports resource type.
Is CopilotCostManagement-Reports.Read.All an application or a delegated permission?
CopilotCostManagement-Reports.Read.All is available as both an application permission (app-only access, no signed-in user) and a delegated permission (access on behalf of a signed-in user).
Does CopilotCostManagement-Reports.Read.All require admin consent?
Application permissions always require admin consent.
What is the permission ID (GUID) for CopilotCostManagement-Reports.Read.All?
For CopilotCostManagement-Reports.Read.All, the application (app role) ID is ec42fb68-397f-40ab-baa1-c8d0b745a680, and the delegated (OAuth2 scope) ID is db3b53cd-01a9-45db-8f48-b97de4e9e8ff. These are the real Microsoft Graph identifiers and can be used directly in an app registration manifest.