Runs over time

GET/api/stats/timeseries

Runs by status in hourly or daily buckets over a window, with every bucket filled.

Needs an API token with the Read permission for runs (run:read).

Parameters

Query

windowOptional · string: 24h, 7d (the default) or 30d, ending now. Anything else reads as 7d.
environmentOptional · string: production (the default), test or all.
bucketOptional · string: hour or day. Left out: hours for 24h, days otherwise. Anything else is refused.

Buckets

Each point’s t is the bucket’s start, in UTC. cancelled is counted apart, never as worked or failed.

Responses

200OK
One point per bucket: 24 for 24h, and 7 or 30 for 7d and 30d with the default buckets. Hourly on 7d is 168. The last is partly filled. Empty buckets are zeros.
400VALIDATION_ERROR
bucket isn’t hour or day.
403FORBIDDEN
The token lacks the Read permission for runs.
500INTERNAL_ERROR
The series couldn’t be read. Try again.

Any call can also answer: 401 UNAUTHORIZED · 401 TOKEN_ENDED · 403 TOKEN_SURFACE_OFF · 403 FEATURE_OFF · 403 EMBED_NOT_ALLOWED · 403 EMBED_NOT_AVAILABLE · 403 ACCOUNT_SUSPENDED · 429 RATE_LIMITED · 503 BUSY · 503 PAUSED · 503 SERVICE_UNAVAILABLE. See Errors.

Request

GORUNNER="https://api.gorunner.io"
GORUNNER_TOKEN="grt_…"  # needs Read for runs

curl "$GORUNNER/api/stats/timeseries?window=24h" \
  -H "Authorization: Bearer $GORUNNER_TOKEN"

const GORUNNER = "https://api.gorunner.io";
const TOKEN = process.env.GORUNNER_TOKEN;

const res = await fetch(
  `${GORUNNER}/api/stats/timeseries?window=24h`,
  {
    headers: { Authorization: `Bearer ${TOKEN}` },
  },
);
const { data } = await res.json();

import os, requests

GORUNNER = "https://api.gorunner.io"
TOKEN = os.environ["GORUNNER_TOKEN"]

res = requests.get(
    f"{GORUNNER}/api/stats/timeseries",
    params={"window": "24h"},
    headers={"Authorization": f"Bearer {TOKEN}"},
)
data = res.json()["data"]

Response · 200 OK, shortened

json

{
  "data": {
    "bucket": "hour",
    "points": [
      {
        "t": "2026-10-25T08:00:00Z",
        "total": 6,
        "completed": 5,
        "failed": 1,
        "cancelled": 0
      },
      "…"
    ]
  }
}

Every field

It takes no body.

Response · 200 OK

dataobject
windowstring: One of 24h, 7d, 30d.
bucketstring: One of hour, day.
pointsarray of objects: A FIXED number of bucket-aligned points, the window divided by the bucket (by default 24 hourly for 24h, 7 daily for 7d, 30 daily for 30d; bucket=hour on 7d gives 168, bucket=day on 24h one), the last one partial, gap-filled with zeros. Always [], never null.
ttime: The bucket’s start, UTC.
completedinteger
failedinteger
cancelledinteger: Runs someone stopped in the bucket: their own segment of a chart, never counted as worked or failed.
totalinteger