---
title: "Recorded usage and historical Active workflow estimates"
method: GET
path: "/v5/workspaces/{workspaceId}/monthly-active"
tags: ["Workspaces"]
---

# Recorded usage and historical Active workflow estimates

`GET /v5/workspaces/{workspaceId}/monthly-active`

## Request

- Base URL: `https://api.kadoa.com`
- URL: `https://api.kadoa.com/v5/workspaces/{workspaceId}/monthly-active`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Historical values come from daily usage snapshots; unavailable values are null. activeWorkflows counts ACTIVE-state workflows, while active and activeSlots count billable usage. Active billing counts real-time workflows or workflows on an enabled schedule. Today's values are computed live. active35 is retired and always null. estimatedActive is a separate display-only workflow estimate; recorded values and slot weights are unchanged. activeEstimateSource identifies calibrated historical ACTIVE counts or bounded interpolation.

## Path parameters

- `workspaceId` string, uuid, required

## Query parameters

- `days` integer

## Headers

- `x-api-key` string
- `Authorization` string

## Response `200`

Daily workflow and slot usage retrieved successfully

- object
  - `days` object[]
    - `date` string: Day (UTC), YYYY-MM-DD
    - `active` integer, nullable: Recorded real-time or enabled scheduled workflow count; null when billing snapshots are unavailable
    - `activeWorkflows` integer, nullable: Recorded ACTIVE-state workflow count; null for missing snapshots
    - `activeSlots` number, float, nullable: Recorded weighted billable slot usage; null when exact history is unavailable
    - `active35` integer, nullable: Retired trailing-35-day comparison; always null
    - `estimatedActive` integer, nullable: Display-only Active billing workflow estimate for missing history; null for recorded days or insufficient evidence
    - `activeEstimateSource` 'historical_active' | 'interpolated', nullable: Estimate method; null when estimatedActive is null

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden - insufficient permissions
- `404`: Workspace not found
- `500`: Internal server error

---

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