Skip to content
UltimateTeam.ai Docs

Public Stats

GET
/api/v1/dogfood/public/stats
curl --request GET \
  --url https://api.ultimateteam.ai/api/v1/dogfood/public/stats \
  --header 'X-API-Key: <X-API-Key>'

Unauthenticated aggregate-only tenant-zero transparency payload.

Cached by the CDN for 5 minutes via Cache-Control: public, max-age=300. Tagged noindex so search bots do not cache the raw JSON.

The response body is a :class:PublicStatsResponse whose fields are a frozen whitelist (DFS-04 PII safety). Any non-whitelisted field is caught by tests/unit/core/dogfood/test_agent_control_service.py and test_public_stats.py long before shipping.

Authorizations

Section titled “Authorizations”

Responses

Section titled “ Responses ”

200

Section titled “200”

Successful Response

Media typeapplication/json
PublicStatsResponse

Aggregate-only tenant-zero stats for the unauthenticated /dogfood transparency page (DFS-04).

PII-free whitelist discriminator. Every field below is numeric or a timestamp. No email addresses, user ids, event ids, outcome ids, actor references, or event payloads are exposed. The test suite asserts set(PublicStatsResponse.model_fields) equals this exact whitelist, so adding any new field is guaranteed to fail a test before it can leak.

Attributes: data_available: False when the underlying aggregate query failed. Consumers must render an “unavailable” state, never a zero or a 100%. action_count_30d: Number of tenant-zero ops-log actions in the last 30 days; None when unavailable. credit_spend_30d: Sum of cost_credits (platform credits, not currency) over the same window; None when unavailable. roi_ratio: Reserved for Phase 199 attribution chain. None until the chain populates outcomes. agent_uptime_pct: Per-role uptime percentage (0-100) computed from the pause history in dogfood_agent_controls, keyed by the 8 C-suite role strings. None when the uptime query failed – an unmeasured role is never reported as 100%. last_autonomous_action_at: UTC timestamp of the most recent tenant-zero ops-log action, or None if no rows exist or the measurement is unavailable.

object
action_count_30d
required
Any of:
integer
agent_uptime_pct
required
Any of:
object
key
additional properties
number
credit_spend_30d
required
Any of:
integer
data_available
required
Data Available
boolean
last_autonomous_action_at
required
Any of:
string format: date-time
roi_ratio
required
Any of:
number
Examplegenerated
{
  "action_count_30d": 1,
  "agent_uptime_pct": {
    "additionalProperty": 1
  },
  "credit_spend_30d": 1,
  "data_available": true,
  "last_autonomous_action_at": "2026-04-15T12:00:00Z",
  "roi_ratio": 1
}