---
title: "Gateway request log"
method: GET
path: "/client/requests"
tags: ["Usage"]
---

# Gateway request log

`GET /client/requests`

## Request

- Base URL: `https://api.roar-ai.com`
- URL: `https://api.roar-ai.com/client/requests`
- Auth: HTTP bearer

One row per model call through `/v1` (tool gateway calls are `GET /client/usage/tools/calls`): model, tokens, cost, latency, time to first token (`ttftMs`, streamed calls) and status. Narrow with `from`/`to`, `keyId`, `model` (one model, exactly), `q` (request id, or text in the model or endpoint) and `band` — `errors`, or `slow`: a streamed call whose first token took over 5s, or an unstreamed one over 30s. Keyset-paginated — pass the previous response's `nextCursor` as `cursor`. Requires `usage:read`.

## Response `200`

Requests, newest first

## Other responses

- `403`: Key lacks usage:read

---

[API](https://skmtc.dev/roar-ai/apis/roar-ai-api.md) · [All operations](https://skmtc.dev/roar-ai/apis/roar-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roar-ai/apis/roar-ai-api/revisions/37e4d0d5a7fe?raw)