Copilot Usage Metrics

Organization metrics

• get-org-metrics.sh <org> [day] — Get aggregated Copilot usage metrics for an organization. Optionally pass a specific day in YYYY-MM-DD format.
• get-org-user-metrics.sh <org> [day] — Get per-user Copilot usage metrics for an organization. Optionally pass a specific day.

Enterprise metrics

• get-enterprise-metrics.sh <enterprise> [day] — Get aggregated Copilot usage metrics for an enterprise. Optionally pass a specific day.
• get-enterprise-user-metrics.sh <enterprise> [day] — Get per-user Copilot usage metrics for an enterprise. Optionally pass a specific day.

Formatting the output

When presenting results to the user:

• Summarize key metrics: total active users, acceptance rate, total suggestions, total chat interactions
• Use tables for per-user breakdowns
• Highlight trends if comparing multiple days
• Note that metrics data is available starting from October 10, 2025, and historical data is accessible for up to 1 year

Important notes

• These API endpoints require GitHub Enterprise Cloud.
• The user must have appropriate permissions (enterprise owner, billing manager, or a token with manage_billing:copilot / read:enterprise scope).
• The "Copilot usage metrics" policy must be enabled in enterprise settings.
• If the API returns 403, advise the user to check their token permissions and enterprise policy settings.