Skip to content
GridRouterhome

Search

Search providers, capabilities and pages

Sign inGet your free API key
Docs
API referenceLogs, drains and alerts

Call log stats

GET
/v1/logs/stats

Calls, error rate, p50/p95/p99 latency, spend, a hit/miss/failed timeline and spend by provider over time, for the same filters as logs_list.

Authorization

bearer
AuthorizationBearer <token>

In: header

Query Parameters

from?string

Start of the window (default: 24 hours ago)

Formatdate-time
to?string

End of the window (default: now)

Formatdate-time
outcome?array<>|
http_status?array<>|
status_min?integer

Lowest HTTP status (inclusive)

Range100 <= value <= 599
status_max?integer

Highest HTTP status (inclusive)

Range100 <= value <= 599
exclude?array<>|

column:value pairs to leave out

provider?array<>|
capability?array<>|
endpoint_id?array<>|
key_id?array<>|
agent_id?array<>|
workspace_id?array<>|
app_id?array<>|
client_name?array<>|
client_kind?array<>|
mode?array<>|
client_mode?array<>|
supply_mode?array<>|
credential?array<>|
error_code?array<>|
country?array<>|
cache?array<>|
billing_verdict?array<>|

Vendor billing verdicts; mismatch = charged_for_miss, double_charged_retry or price_mismatch

latency_min?|
Range0 <= value
latency_max?|
Range0 <= value
cost_min?|
Range0 <= value
cost_max?|
Range0 <= value
q?string

Search call, parent or run id, endpoint or error code (substring)

Match^[A-Za-z0-9_.-]{1,128}$
parent_id?string
Match^[A-Za-z0-9_.:/@-]{1,200}$

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/logs/stats"
{  "from": "2019-08-24T14:15:22Z",  "to": "2019-08-24T14:15:22Z",  "interval_seconds": 0,  "calls": 0,  "hits": 0,  "misses": 0,  "errors": 0,  "error_rate": 0,  "cost_micro": 0,  "p50_ms": 0,  "p95_ms": 0,  "p99_ms": 0,  "timeline": [    {      "ts": "2019-08-24T14:15:22Z",      "hit": 0,      "miss": 0,      "failed": 0,      "cost_micro": 0    }  ],  "by_provider": [    {      "provider": "string",      "calls": 0,      "errors": 0,      "cost_micro": 0,      "p95_ms": 0    }  ],  "spend": [    {      "ts": "2019-08-24T14:15:22Z",      "provider": "string",      "cost_micro": 0    }  ]}

Get a live tail ticket POST

A single-use ticket valid for 60 seconds that opens GET /v1/logs/live without an Authorization header (browsers). Carries logs:read for this org only.

Tail the live log GET

The newest events from the live tail (calls, waterfall run steps, jobs, lists and alerts), newest last, with the same filters as the stream: provider, capability, status, key, app, run or waterfall, minimum latency and cost, sample and fields. Stream them with GET /v1/logs/live or the logs://live MCP resource.