---
title: "Get Org Insights Metrics"
method: GET
path: "/v2/organizations/{orgId}/insights/metrics"
tags: ["Organizations"]
---

# Get Org Insights Metrics

`GET /v2/organizations/{orgId}/insights/metrics`

## Request

- Base URL: `https://api.duvo.ai`
- URL: `https://api.duvo.ai/v2/organizations/{orgId}/insights/metrics`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/duvo/apis/duvo-public-api/docs/v2/organizations/:orgId/insights/metrics/get.ts> (a function with typed inputs; its response is checked against the schema)

Get org-level insights metrics (runs, assignments, schedules) broken down per team across the organization. Requires an organization Admin, Executive, or Owner role.

## Path parameters

- `orgId` string, uuid, required

## Query parameters

- `startDate` string, date-time
- `endDate` string, date-time

## Response `200`

Default Response

- object
  - `teams` object[], required: Per-team metric breakdown
    - `team_id` string, uuid, required: Team's unique identifier
    - `team_name` string, required: Team name
    - `is_deleted` boolean, required: Whether the team is soft-deleted
    - `member_count` number, required: Number of members on the team
    - `assignment_count` number, required: Number of (non-deleted) agents on the team
    - `scheduled_job_count` number, required: Number of enabled schedules on the team's agents
    - `total_jobs` number, required: Scheduled runs in the window (source = scheduling)
    - `completed_jobs` number, required: Scheduled runs that completed
    - `failed_jobs` number, required: Scheduled runs that failed
    - `total_runs` number, required: All runs in the window across sources
  - `start_date` string, required: Effective window start after clamping (ISO 8601)
  - `end_date` string, required: Effective window end after clamping (ISO 8601)
  - `truncated` boolean, required: True when the org has more teams than the aggregation limit — the team list is partial
  - `total_teams` number, required: Actual team count on the org, even when truncated
  - `org_member_count` number, required: Distinct organization members (not the sum of per-team memberships)

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `500`: Default Response

---

[API](https://skmtc.dev/duvo/apis/duvo-public-api.md) - [All operations](https://skmtc.dev/duvo/apis/duvo-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duvo/apis/duvo-public-api/revisions/dafcf3d868a9?raw)