Get a request log

GET/v1/logs/{id}

Get a request log.

Returns one log row in full: everything the search returns, plus the request and response bodies when the organization stores them, the error message of a failed request, the declared tools and the guardrail details. Fails with 404 when there is no log with this id.

Requires access to the log's workspace: an organization owner or admin, a member of the workspace, an organization-scoped va_ key with the admin role, or a va_ key scoped to the workspace.

Authorization

AuthorizationBearer va_
A platform API key (va_...), created under Settings > API keys. Scoped to an organization or one workspace, with an admin or member role. Used by the management API.

Path parameters

idstringrequired
the log's id, as returned in id by the search

Responses

200application/json

idstring
The log's id (UUID). Use it to read the log in full.
request_idstring
The request id the call ran under: the caller's X-Request-ID, or one the gateway generated. For a Message Batch request, <batch id>/<custom_id>.
created_atstring<date-time>
When the request was logged (ISO 8601 date-time).
providerstring
The provider the request went to, upper case with underscores, e.g. OPENAI or VERTEX_AI.
modelstring
The model id the request asked for.
status_codeinteger<int32>
The HTTP status the request ended with. 499 means the caller disconnected during a stream.
duration_msinteger<int64>
How long the request took at the gateway, in milliseconds.
streamingboolean
Whether the response was streamed.
organizationstring
The slug of the organization the request belongs to.
user_idstring
The end user the caller attributed the request to (the request's user field, or metadata.user_id on Claude Messages); null when none was sent.
prompt_tokensinteger<int32>
Input tokens, cached input included. Null when the provider reported no usage.
completion_tokensinteger<int32>
Output tokens. Null when the provider reported no usage.
total_tokensinteger<int32>
Input plus output tokens. Null when the provider reported no usage.
costnumber<double>
What the request cost, in USD, including the platform markup on a PLATFORM virtual key. 0 on a cache hit; null when the model has no price.
cost_saved_usdnumber<double>
What a cache hit would have cost, in USD (cost is 0 on a hit); null on every other request.
cache_statusstring
The response cache result: HIT, SEMANTIC_HIT, MISS, BYPASS, DISABLED or REFRESH.
error_messagestring
Why a failed request failed, with the provider's own message when the provider refused it; null on success.
retry_countinteger<int32>
How many times the gateway retried the call (see x-retry-count).
fallback_providerstring
The fallback provider that served the request when the primary failed; null when no fallback was used.
virtual_key_slugstring
The virtual key the request was made with (vk-...); null for direct provider credentials.
workspace_idstring<uuid>
The workspace the request belongs to (UUID); null when it has none.
config_slugstring
The routing config the request was routed through; null when none was used.
guardrail_slugstring
The guardrails that applied to the request, comma-separated (gr-...); null when none did.
guardrail_statusstring
The combined guardrail result over the input and output checks: PASS, MONITOR, REDACT, BLOCK or BYPASS; null when no guardrail applied.
tool_scan_statusstring
The result of the scan of the tool results the request fed back to the model: PASS, MONITOR, REDACT or BLOCK; null when the request carried no tool results.
initiatorstring
MCP_SERVER when the MCP Gateway made this request on behalf of an MCP server's sampling request; null otherwise.
mcp_server_slugstring
The MCP server whose sampling request this request answered; null otherwise.
regionstring
The AWS region that served the request and holds this log, e.g. us-east-2; null on logs written before it was recorded.
tool_call_namesstring[]
The function names the model asked to call, in the order it asked; null or empty when it asked for none.
tool_result_countinteger<int32>
How many tool results (tool-role messages) the request carried.
declared_tool_countinteger<int32>
How many tools the caller declared on the request.
declared_toolsmap<string, object>[]
The tools declared on the request: each one's name and the schema_hash of its definition.
request_bodystring
The request as sent, as JSON text, with inline images, files and audio elided. Null unless the organization stores request and response bodies.
response_bodystring
The response, as JSON text (a streamed answer is rebuilt whole), or the provider's error body on a failed request. Null unless the organization stores request and response bodies.
operation_typestring
The kind of operation, e.g. embedding, transcription, image_generation, file_upload, batch_create, response_create, message_batch, system_one or openai_decision; null for chat and Claude Messages requests.
file_size_bytesinteger<int64>
The size of the uploaded file or audio, in bytes; only on file and audio operations.
mime_typestring
The media type of the uploaded file or audio; only on file and audio operations.
media_formatstring
The audio or response format of an audio or image operation, e.g. mp3 or json.
image_sizestring
The requested image size, e.g. 1024x1024; only on image operations.
image_qualitystring
The requested image quality, e.g. standard or hd; only on image operations.
image_countinteger<int32>
How many images were generated; only on image operations.
audio_duration_secondsnumber<double>
The length of the audio, in seconds; only on audio operations.
voicestring
The voice used for text-to-speech; only on speech operations.
resolved_modelstring
The versioned model that answered when the request named an alias; only on System One and Decisions requests.
question_countinteger<int32>
How many questions the request asked; only on System One and Decisions requests.
min_confidencenumber<double>
The lowest confidence among the answers' choices and scores, 0 to 1; only on System One and Decisions requests.

VectorAxis is built by GK Labs, a member of NVIDIA Inception.