> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inference.net/llms.txt
> Use this file to discover all available pages before exploring further.
# Inferences
> List, filter, sort, and export inference requests and responses captured by Gateway.
Inspect inference requests and responses captured by Gateway. List and filter inferences in the active project, sort by tokens / cost / latency, discover the available filter values, and fetch the complete stored request and response bodies.
**Alias:** `inf inferences`
## `inf inference list`
List and filter inferences in the active project.
```bash theme={"system"}
inf inference list
```
**Alias:** `inf inference ls`
### Options
| Flag | Required | Description | Default |
| ----------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
| `-l, --limit ` | No | Maximum number of results (1–100) | `20` |
| `--sort ` | No | Sort key: `sent_at`, `http_code`, `cost`, `duration`, `tokens`, `input_tokens`, `output_tokens`, `input_size`, `output_size` | `sent_at` |
| `--order ` | No | Sort order | `desc` |
| `--filter ` | No | Numeric filter `` (repeatable). Fields: `inputTokens`, `outputTokens`, `inputSizeBytes`, `outputSizeBytes`, `durationMs`, `totalCost`. Ops: `> >= < <= = !=` | — |
| `--metadata ` | No | Metadata filter `` (repeatable). Ops: `= != ~ !~`, plus ` is_empty` / ` is_not_empty` | — |
| `-m, --model ` | No | Filter by model (repeatable or comma-separated) | All models |
| `--provider ` | No | Filter by downstream provider (repeatable or comma-separated) | All |
| `--environment ` | No | Filter by environment (repeatable or comma-separated) | All |
| `--status ` | No | Filter by HTTP status code, e.g. `200,500` (repeatable or comma-separated) | All |
| `--task ` | No | Filter by task ID — matches the `x-inference-task-id` header set by [`inf instrument --task-id`](/cli/instrument) (repeatable or comma-separated) | — |
| `--upload ` | No | Filter by upload ID (repeatable or comma-separated) | — |
| `--stream ` | No | Filter by streamed responses (`true` / `false`) | — |
| `--from ` / `--to ` | No | Absolute time range (ISO-8601). Use both together. | — |
| `--range ` | No | Relative time range: `1h, 6h, 12h, 1d, 3d, 7d, 14d, 30d, 90d, all` | — |
| `--cursor ` | No | Pagination cursor (from a previous `--json` response) | — |
Don't hardcode filter values — run [`inf inference facets`](#inf-inference-facets) to discover the valid models, providers, environments, tasks, and metadata keys for the active project, along with the full filter reference.
The human-readable table shows the inference ID, model, status code (color-coded), input/output token counts, latency, cost, and timestamp. Add the global `--json` flag to emit the **full result object** — `{ items, nextCursor, hasMore, totalCount }` — so scripts can read `.items` and paginate by passing `.nextCursor` back via `--cursor`.
### Examples
```bash theme={"system"}
# List the 10 most recent inferences
inf inference list --limit 10
# Largest-input requests first — e.g. find prompts over 39k tokens
inf inference list --sort input_tokens --order desc --limit 50
inf inference list --filter inputTokens>39000
# Combine numeric, array, and metadata filters over a time window
inf inference list --model meta-llama/llama-3.1-8b-instruct/fp-8 --status 200 --range 7d
inf inference list --filter durationMs>5000 --metadata user_id=abc123
# Paginate from a script — JSON output includes nextCursor
cursor=$(inf --json inference list --sort input_tokens --order desc | jq -r '.nextCursor')
inf --json inference list --sort input_tokens --order desc --cursor "$cursor"
```
## `inf inference facets`
Probe the active project for the values you can filter on — models, providers, environments, task IDs, and metadata keys — plus the full numeric/metadata/sort reference. Values are discovered from your data, not hardcoded, which makes this the starting point for building a filtered `inf inference list` query (and a one-call way for an AI agent to learn the filter surface).
**Alias:** `inf inference filters`
```bash theme={"system"}
inf inference facets
```
Add the global `--json` flag to emit a machine-readable object combining the probed values with a static `reference` (numeric fields, operators, and sort keys).
## `inf inference get`
Fetch the **complete stored request and response** for a specific inference — method, path, headers, and the full request/response bodies (returned only when payload storage was enabled for the request; otherwise the sides come back `null`). Useful for debugging specific calls, inspecting model behavior, or archiving payloads.
```bash theme={"system"}
inf inference get
```
### Arguments
| Argument | Required | Description |
| -------- | -------- | -------------------------------------------- |
| `id` | Yes | Full inference UUID or a 4+ character prefix |
### Options
| Flag | Required | Description | Default |
| --------------------- | -------- | ----------------------------------------------------------------------------------------------- | ------- |
| `--request` | No | Output only the request (omit the response) | Both |
| `--response` | No | Output only the response (omit the request) | Both |
| `--body` | No | Output only the raw body content (no method/path/headers). Requires `--request` or `--response` | — |
| `-o, --output ` | No | Write the output to a file instead of stdout | stdout |
Add the global `--json` flag to print the full `{ request, response }` payload (method, path, headers, and complete bodies) as clean JSON for piping into `jq` or saving.
### Examples
```bash theme={"system"}
# Using a 4+ character UUID prefix (human-readable view)
inf inference get inf_abc1
# Pull a full UUID from list output, then fetch it
inf inference list --json | jq -r '.items[0].id' | xargs inf inference get
# Full request + response as clean JSON, then extract the response body
inf --json inference get | jq '.response.body'
# Dump just the raw response body to a file
inf inference get --response --body -o response.json
```