REST API

Aggregate & Spend

On this page

Org aggregate
LLM spend summary
LLM spend timeseries

Org-level views that cut across every workspace.

Org aggregate

HTTP

GET /v1/observ/orgs/{org}/aggregate

One metric aggregated across the organization, grouped by a dimension.

Auth: API key or JWT · Role: dev (org-scoped)

Query parameters

Name	Type	Required	Default	Description
`metric`	string	✅	—	`reliability_avg` \| `cost_sum` \| `latency_p95`
`groupby`	string	➖	`workspace`	`workspace` \| `project`
`since`	string \| null	➖	`null`	ISO 8601 UTC lower bound

Examples

agg = evigauge.get("/v1/observ/orgs/{org}/aggregate", params={
    "metric": "cost_sum", "groupby": "workspace", "since": "2026-08-01T00:00:00Z",
})
print(agg)

const agg = await evigauge.get("/v1/observ/orgs/{org}/aggregate", {
  metric: "cost", groupby: "workspace", since: "2026-08-01T00:00:00Z",
});
console.log(agg);

Errors

Status	Cause
`422`	`metric` omitted, or a `metric` / `groupby` value outside the accepted set (both are pattern-validated)

LLM spend summary

HTTP

GET /v1/observ/orgs/{org}/observability/llm-spend/summary

Org-wide LLM spend for one period.

Auth: API key or JWT · Role: dev (org-scoped)

Query parameters

Name	Type	Required	Default	Description
`period`	string	➖	`month`	`day` \| `week` \| `month`

Examples

s = evigauge.get("/v1/observ/orgs/{org}/observability/llm-spend/summary",
                 params={"period": "month"})
print(s)

const s = await evigauge.get(
  "/v1/observ/orgs/{org}/observability/llm-spend/summary", { period: "month" });
console.log(s);

LLM spend timeseries

HTTP

GET /v1/observ/orgs/{org}/observability/llm-spend/timeseries

Auth: API key or JWT · Role: dev (org-scoped)

Query parameters

Name	Type	Required	Default	Description
`days`	integer	➖	`30`	Days of history

Examples

ts = evigauge.get("/v1/observ/orgs/{org}/observability/llm-spend/timeseries",
                  params={"days": 90})
print(ts)

const ts = await evigauge.get(
  "/v1/observ/orgs/{org}/observability/llm-spend/timeseries", { days: 90 });
console.log(ts);