---
title: "Time-bucketed usage series for one adoption/usage vertical (admin only)"
method: GET
path: "/v1/admin/stats/growth-timeseries"
tags: ["Admin"]
---

# Time-bucketed usage series for one adoption/usage vertical (admin only)

`GET /v1/admin/stats/growth-timeseries`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/admin/stats/growth-timeseries`
- Auth: HTTP bearer

Gap-filled counts (24h → hourly, 7d/30d/90d → daily, 365d → weekly) for one of 15 adoption/usage verticals, plus a period-over-period delta. Backs both the live admin analytics dashboard and the weekly investor report — same source, two surfaces.

## Query parameters

- `vertical` 'signups_orgs' | 'signups_users' | 'subscriptions_new' | 'subscriptions_churned' | 'shroud_usage' | 'shroud_security' | 'intents_execution' | 'intents_transactions' | 'vault_usage' | 'runtime_usage' | 'memory_usage' | 'automations' | 'agent_wallets_created' | 'embedded_wallets_created' | 'embedded_wallets_used' | 'platform_api', required
- `period` '24h' | '7d' | '30d' | '90d' | '365d'

## Response `200`

Time-bucketed series for the requested vertical

- GrowthTimeseriesResponse
  - `vertical` string, required
  - `period` string, required
  - `bucket_unit` 'hour' | 'day' | 'week', required
  - `points` GrowthCountBucket[], required
    - `bucket` string, date-time, required
    - `count` integer, required
  - `total` integer, required
  - `prior_total` integer, required
  - `delta_pct` number, nullable: Null when both the current and prior totals are 0.
  - `notes` string, nullable: A known limitation worth surfacing for this vertical (e.g. a source table with no org_id to exclude test-fixture activity from). Null for the clean verticals.

## Other responses

- `400`: Invalid request
- `403`: Insufficient permissions

---

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