Discovery

Read the telemetry of a single request

Returns the telemetry record (api_usage_stats) for a request_id. The id is CLIENT-SUPPLIED (echo of the X-Request-Id header) and therefore NOT unique across tenants, so the query is ALWAYS scoped to the keys the caller owns:

  • child: its own api_key_id only.
  • master: the key set of its organization.
  • solo/legacy: the keys of the caller's own user_id.

The MOST RECENT owned row (created_at DESC) is returned as the main object, with occurrences = number of owned matches. Uniform 404 (anti-enumeration): a nonexistent request_id and one that «exists but is not yours» return exactly the same NOT_FOUND, so one tenant cannot probe another's ids.

get/api/v1/requests/{requestId}

Request

  • Base URL: https://legal.nexusquantum.legal
  • URL: https://legal.nexusquantum.legal/api/v1/requests/{requestId}
  • Auth: HTTP bearer

Path parameters

requestIdstring required

Request identifier (echo of X-Request-Id).

Response

Telemetry record (most recent owned match).

request_idstring required

Request identifier (echo of X-Request-Id).

endpointstring required
status_codeinteger required
okboolean required

status_code < 400.

latency_msinteger nullable
modelstring nullable

Label of the engine that ANSWERED, not a stable model identifier. It is the chain's own label — 'DeepSeek V4-Pro', 'Opus 4.8 · OpenRouter' — or, when the firm brings its own engine, that engine's model id. In mode=deep it is composed as '<analyst>+<auditor>'. unknown means nobody could be named: the value is never guessed. Under partner or neutral branding it is replaced by a neutral label. Do NOT key logic on this string: which engine answers is a deployment decision and the chain falls back on its own.

provider_idstring nullable

Id of the BYO provider (llm_provider_configs.id) that served the request; null = platform chain. Additive (v1.30.0).

routing_policy'own_only' | 'own_then_platform' | 'platform' nullable

Effective routing policy. Additive (v1.30.0).

error_codestring nullable
tokens_usedinteger nullable
input_charsinteger nullable
api_key_idstring nullable
key_prefixstring nullable

Prefix of the matching key (join with api_keys).

created_atstring date-time required
occurrencesinteger required

Number of your own rows sharing this request_id.

requestIdstring

Id of this endpoint call itself (X-Request-Id header).

Example response

{
  "endpoint": "/api/v1/analyze",
  "status_code": 200,
  "model": "DeepSeek V4-Pro+deepseek-v4-pro",
  "key_prefix": "nlk_ab12"
}

Changes

No recorded changes to this operation across all 1 revision of this API.