---
title: "Get Session Metrics"
method: GET
path: "/v3/enterprise/metrics/sessions"
tags: ["metrics"]
---

# Get Session Metrics

`GET /v3/enterprise/metrics/sessions`

Get aggregated session metrics for the enterprise account.

Optionally filter by playbook_id to get metrics for sessions created with a specific playbook.

## Query parameters

- `user_ids` string[], nullable
- `service_user_ids` string[], nullable
- `time_before` integer, required
- `time_after` integer, required
- `org_ids` string[], nullable
- `playbook_id` string, nullable

## Response `200`

Successful Response

- SessionMetricsResponse — Response model for session metrics.
  - `avg_acus_per_session` number, required
  - `sessions_created_by_origin` SessionCountsByOrigin, required — Session counts by origin type, exposed on the v3 metrics API. A curated subset of `SessionOrigin`: legacy origins (cli, vscode_extension, devin_spaces) are intentionally not surfaced. Counts for sessions with a `scheduled` DB origin roll into `automation` via the canonical `db_origin_to_api` mapping, since automations are a superset that schedules will migrate into.
    - `api` integer
    - `automation` integer
    - `code_scan` integer
    - `desktop` integer
    - `jira` integer
    - `linear` integer
    - `slack` integer
    - `teams` integer
    - `webapp` integer
  - `sessions_created_by_size` SessionCountsBySize, required — Session counts by size category.
    - `l` integer
    - `m` integer
    - `s` integer
    - `xl` integer
    - `xs` integer
  - `sessions_created_count` integer, required
  - `sessions_created_with_playbook_count` integer, required
  - `sessions_created_with_search_count` integer, required
  - `sessions_with_merged_prs_by_size` SessionCountsBySize, required — Session counts by size category.
    - `l` integer
    - `m` integer
    - `s` integer
    - `xl` integer
    - `xs` integer
  - `sessions_with_merged_prs_count` integer, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Content
- `429` — Too Many Requests

---

[API](https://skmtc.net/devin/apis/devin-api-v1.md) · [All operations](https://skmtc.net/devin/apis/devin-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/devin/devin-api-v1/revisions/e3244476af1c/schema)