---
title: "Get Copilot usage records for an enterprise"
method: GET
path: "/enterprises/{enterprise}/copilot/usage-records"
tags: ["copilot"]
---

# Get Copilot usage records for an enterprise

`GET /enterprises/{enterprise}/copilot/usage-records`

> [!NOTE]
> This endpoint is in public preview and is subject to change.

Use this endpoint to retrieve Copilot agent session activity records for a specific enterprise. The endpoint provides comprehensive observability into Copilot session data across your enterprise.

The response includes detailed usage records aggregated and forwarded from all Copilot clients where your end users operate under enterprise-paid Copilot licenses. This includes cloud agents operating on github.com and data resident deployments on ghe.com, Copilot CLI, VS Code, Visual Studio, and partner IDEs such as those provided by JetBrains and Eclipse.

Only EMU (GHEC and GHEC with Data Residency) enterprise owners can access this endpoint.

OAuth app tokens and personal access tokens (classic) need the `read:enterprise` scope to use this endpoint.

## Path parameters

- `enterprise` string, required

## Query parameters

- `phrase` string
- `per_page` integer
- `after` string
- `before` string
- `order` 'desc' | 'asc'

## Response `200`

Response

- object[]
  - `type` string — The record type (request or response).
  - `user_id` integer — The ID of the user who made the request.
  - `enterprise_id` integer — The ID of the enterprise.
  - `github_request_id` string — The GitHub request ID.
  - `endpoint` string — The API endpoint called.
  - `body` string — The request or response body.
  - `@timestamp` integer — Milliseconds since Unix epoch.
  - `event_id` string — The source-assigned event ID.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Resource not found
- `422` — Validation failed, or the endpoint has been spammed.

---

[API](https://skmtc.net/github/apis/github-v3-rest-api-2.md) · [All operations](https://skmtc.net/github/apis/github-v3-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/github-v3-rest-api-2/versions/8ae6d0c8716e/schema)