---
title: "Get a request trace"
method: GET
path: "/requests/{id}"
---

# Get a request trace

`GET /requests/{id}`

## Request

- Base URL: `https://www.ninjachat.ai/api/v1`
- URL: `https://www.ninjachat.ai/api/v1/requests/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

Success.

- RequestRecordResponse
  - `object` 'request', required
  - `request_id` string, required
  - `timestamp` string, nullable, required
  - `endpoint` string, nullable, required
  - `model_requested` string, nullable, required
  - `model` string, nullable, required
  - `provider` string, nullable, required
  - `tokens` object, required
    - `input` number, nullable, required
    - `output` number, nullable, required
    - `reasoning` number, nullable, required
    - `cached` number, nullable, required
    - `cache_write` number, nullable, required
  - `cost_cents` number, nullable, required
  - `metered_cost_cents` number, nullable, required
  - `latency_ms` number, nullable, required
  - `ttfb_ms` number, nullable, required
  - `status_code` integer, nullable, required
  - `retries` integer, nullable, required
  - `error_code` string, nullable, required
  - `routing` object, nullable, required
    - `requested_models` string[], required
    - `policy` object, nullable, required
      - `strategy` 'balanced' | 'cost' | 'latency' | 'quality', required
      - `data_policy` 'default' | 'no_training' | 'zero_retention', required
      - `caching` 'auto'
      - `source` 'request' | 'project' | 'default', required
      - `allow_fallbacks` boolean, required
      - `require_parameters` boolean, required
      - `providers` object, required
        - `only` string[]
        - `exclude` string[]
        - `order` string[]
      - `max_cost_usd` number
    - `ordering` 'breaker' | 'perf' | 'static', required
    - `considered` string[], required
    - `excluded` object[], required
      - `model` string, required
      - `stage` string, required
      - `reason` string, required
    - `attempts` object[], required
      - `model` string, required
      - `outcome` 'ok' | 'error' | 'timeout' | 'aborted', required
      - `error_code` string, nullable, required
      - `latency_ms` number, required
      - `retry_budget_consumed` boolean, required
    - `served_by` object, nullable, required
      - `model` string, required
      - `provider` string, nullable, required
      - `attempt_index` integer, required

## Other responses

- `400`: Invalid or unsupported request parameter.
- `401`: Missing or invalid API key.
- `402`: Insufficient balance or project spend limit reached.
- `429`: Rate limit exceeded.
- `500`: Gateway error.

---

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