---
title: "Daily per-billing-period cumulative series for Approved workflows and extracted rows (teams and organizations)"
method: GET
path: "/v5/workspaces/{workspaceId}/period-series"
tags: ["Workspaces"]
---

# Daily per-billing-period cumulative series for Approved workflows and extracted rows (teams and organizations)

`GET /v5/workspaces/{workspaceId}/period-series`

## Request

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

For each of the last N days, the Approved-workflow count, weighted slot usage, and extracted-row sum accumulated since the start of the billing period that day falls in, resetting at each renewal anniversary (a sawtooth across renewals). approved = distinct workflows with at least one FINISHED non-preview run in [periodStart(day), day]; approvedSlots sums their multipliers; rows sums total_records. The series is run-fact-based, so it are drift-free and fully backfilled. At today, approved equals currentContractActiveWorkflows and rows equals currentPeriodExtractedRows from the quotas endpoint.

## Path parameters

- `workspaceId` string, uuid, required

## Query parameters

- `days` integer

## Headers

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

## Response `200`

Period-cumulative daily history retrieved successfully

- object
  - `days` object[]
    - `date` string: Day (UTC), YYYY-MM-DD
    - `approved` integer: Distinct workflows that ran (FINISHED, non-preview) since the start of that day's billing period
    - `approvedSlots` number, float: Weighted slot usage for approved
    - `rows` integer: Extracted rows (sum of total_records) for those in-period runs up to that day

## 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)