---
title: "Retrieve analytics for specific flow"
method: GET
path: "/flows/{flowID}/usage"
tags: ["Flows", "Usage"]
---

# Retrieve analytics for specific flow

`GET /flows/{flowID}/usage`

Get comprehensive analytics for a single flow including all breakdowns

## Path parameters

- `flowID` integer, required

## Response `200`

flow analytics received successful

- object
  - `data` object
    - `flow_id` integer
    - `flow_stats_by_flow` ModelsFlowStats, required
      - `total_assistants_count` integer
      - `total_subtasks_count` integer
      - `total_tasks_count` integer
    - `toolcalls_stats_by_flow` ModelsToolcallsStats, required
      - `total_count` integer
      - `total_duration_seconds` number
    - `toolcalls_stats_by_function_for_flow` ModelsFunctionToolcallsStats[]
      - `avg_duration_seconds` number
      - `function_name` string, required
      - `is_agent` boolean
      - `total_count` integer
      - `total_duration_seconds` number
    - `usage_stats_by_agent_type_for_flow` ModelsAgentTypeUsageStats[]
      - `agent_type` string, required
      - `stats` ModelsUsageStats, required
        - `total_usage_cache_in` integer
        - `total_usage_cache_out` integer
        - `total_usage_cost_in` number
        - `total_usage_cost_out` number
        - `total_usage_in` integer
        - `total_usage_out` integer
    - `usage_stats_by_flow` ModelsUsageStats, required
      - `total_usage_cache_in` integer
      - `total_usage_cache_out` integer
      - `total_usage_cost_in` number
      - `total_usage_cost_out` number
      - `total_usage_in` integer
      - `total_usage_out` integer
  - `status` string

## Other responses

- `400` — invalid flow id
- `403` — getting flow analytics not permitted
- `404` — flow not found
- `500` — internal error on getting flow analytics

---

[API](https://skmtc.dev/vxcontrol/apis/pentagi-swagger-api.md) · [All operations](https://skmtc.dev/vxcontrol/apis/pentagi-swagger-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vxcontrol/pentagi-swagger-api/revisions/7c1cbf7abaa1/schema)