Reporting
Query Reports
Returns time-series analytics for AI usage, cost, latency, evaluator results, and guardrail outcomes. Select a metric and time range, break results down by supported dimensions, apply filters, and optionally include totals for the full range.from orq_ai_sdk import Orq
from orq_ai_sdk.utils import parse_datetime
import os
with Orq(
api_key=os.getenv("ORQ_API_KEY", ""),
) as orq:
res = orq.reporting.query(metric="genai.evaluator.score.avg", from_=parse_datetime("2026-03-06T12:20:53.904Z"), to=parse_datetime("2026-12-14T22:21:09.964Z"))
# Handle response
print(res)
Show Parameters
Show Parameters
{
"metric": Literal["genai.requests", "genai.tokens", "genai.cost", "genai.errors", "genai.latency.p50", "genai.latency.p95", "genai.latency.p99", "genai.evaluator.runs", "genai.evaluator.pass_rate", "genai.evaluator.score.avg", "genai.guardrail.runs", "genai.guardrail.block_rate", "genai.guardrail.triggered", "genai.usage"], # required
"from_": date, # required
"to": date, # required
"grain": Optional[Literal["auto", "minute", "hour", "day"]],
"group_by": List[Literal["project", "identity", "provider", "model", "product", "api_key", "status_code", "http_status_code", "credential_type", "dimension", "dimension_type", "tag", "agent", "tool", "deployment", "evaluator", "dataset", "prompt", "policy", "conversation", "thread", "memory_store", "knowledge", "sheet", "guardrail_origin", "evaluator_name", "evaluator_type", "evaluator_version", "result_type", "evaluation_stage", "guardrail_stage", "evaluator_stage", "guardrail_action", "result_label"]],
"filters": { # optional
"field": Optional[Literal["project", "identity", "provider", "model", "product", "api_key", "status_code", "http_status_code", "credential_type", "billing_billable", "dimension", "dimension_type", "tag", "agent", "tool", "deployment", "evaluator", "dataset", "prompt", "policy", "conversation", "thread", "memory_store", "knowledge", "sheet", "guardrail_origin", "evaluator_name", "evaluator_type", "evaluator_version", "result_type", "evaluation_stage", "guardrail_stage", "evaluator_stage", "guardrail_action", "result_label"]],
"op": Optional[Literal["eq", "neq", "in", "not_in"]],
"values": List[str],
},
"limit": Optional[int],
"time_zone": Optional[str],
"include_totals": Optional[bool],
}
Show Response
Show Response
{
"object": Optional[Literal["report"]],
"data": { # optional
"timestamp": date,
"dimensions": Dict[str, str],
"metrics": Dict[str, float],
},
"totals": { # optional
"metrics": Dict[str, float],
},
"has_more": Optional[bool],
"meta": { # optional
"effective_grain": Optional[Literal["minute", "hour", "day"]],
"row_count": Optional[int],
"request_id": Optional[str],
"currency": Optional[Literal["USD"]],
"warnings": List[str],
},
}