---
title: "Get a span"
method: GET
path: "/api/request-logs/{unique_id}/"
tags: ["Spans"]
---

# Get a span

`GET /api/request-logs/{unique_id}/`

## Request

- Base URL: `https://api.respan.ai`
- URL: `https://api.respan.ai/api/request-logs/{unique_id}/`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns the full span, including evaluation scores and credit and budget information (`limit_info`). Metadata keys beginning with `_` are reserved for platform use and omitted from span and trace read responses.

## Path parameters

- `unique_id` string, required

## Response `200`

Successful response for Retrieve span

- object: Full customer-facing span detail. Additional stored or enrichment fields may be present. For usage-capped records, the server can instead return a reduced object with `blurred: true`.
  - `id` string, required: Span ID (alias of `unique_id`).
  - `unique_id` string: Stored unique span ID.
  - `span_unique_id` string: Tracing span ID, when supplied.
  - `trace_unique_id` string: Parent trace ID.
  - `span_name` string: Span name.
  - `span_parent_id` string: Parent span ID.
  - `span_workflow_name` string: Workflow name associated with the span.
  - `timestamp` string, date-time: Completion timestamp.
  - `start_time` string, date-time: Start timestamp.
  - `period_start` string, date-time: Billing/aggregation period start.
  - `period_end` string, date-time: Billing/aggregation period end.
  - `input` union: Canonical span input.
    - string
    - object
    - unknown[]
      - unknown
    - number
    - boolean
  - `output` union: Canonical span output.
    - string
    - object
    - unknown[]
      - unknown
    - number
    - boolean
  - `prompt_messages` object[]
  - `completion_message` object
  - `completion_messages` unknown[]
    - unknown
  - `full_request` object: Credential-sanitized full request.
  - `full_response` object: Credential-sanitized full response.
  - `model` string: Model used by the span.
  - `provider_id` string: Provider route used by the span.
  - `environment` string: API-key environment.
  - `log_type` string: Span/log type.
  - `log_method` string: How this span was ingested.
  - `status` string: Span status.
  - `status_code` integer: HTTP or application status code.
  - `error_code` string: Normalized error code.
  - `error_message` string: Error message, when the span failed.
  - `warnings` union: Warnings captured for the request.
    - string
    - object
    - unknown[]
      - unknown
    - number
    - boolean
  - `prompt_tokens` integer: Input token count.
  - `completion_tokens` integer: Output token count.
  - `total_request_tokens` integer: Total token count.
  - `prompt_cache_hit_tokens` integer: Cached input-token count.
  - `prompt_cache_creation_tokens` integer: Cache-creation input-token count.
  - `reasoning_tokens` integer: Reasoning-token count.
  - `cost` number: Cost in USD.
  - `latency` number: End-to-end latency in seconds.
  - `time_to_first_token` number: Time to first token in seconds.
  - `tokens_per_second` number: Output throughput.
  - `routing_time` number: Gateway routing time.
  - `metadata` object: Customer metadata. Keys beginning with `_` are reserved and omitted from customer-facing responses.
  - `properties` union: Typed span properties.
    - string
    - object
    - unknown[]
      - unknown
    - number
    - boolean
  - `variables` object
  - `tools` object[]
  - `tool_calls` object[]
  - `scores` object: Evaluation scores keyed by evaluator identifier or slug.
  - `customer_identifier` string: End-customer identifier.
  - `customer_email` string: End-customer email.
  - `customer_name` string: End-customer name.
  - `custom_identifier` string: Indexed custom identifier.
  - `group_identifier` string: Group identifier.
  - `session_identifier` string: Session identifier.
  - `thread_identifier` string: Conversation thread identifier.
  - `organization_id` string: Organization UUID.
  - `unique_organization_id` string: Organization UUID.
  - `organization_key_id` string: API-key identifier.
  - `organization_key_name` string: API-key display name.
  - `prompt_id` string: Prompt family ID.
  - `prompt_name` string: Prompt display name.
  - `prompt_version_number` integer: Prompt version number.
  - `deployment_id` string: Deployment ID.
  - `deployment_name` string: Deployment name.
  - `stream` boolean: Whether the response streamed.
  - `temperature` number: Sampling temperature.
  - `top_p` number: Nucleus-sampling parameter.
  - `max_tokens` integer: Configured generation limit.
  - `response_format` object
  - `limit_info` object
    - `is_allowed` boolean
    - `limits` object[]
      - `name` string
      - `current_value` number
      - `new_value` number
      - `limit_value` number
      - `is_within_limit` boolean
  - `blurred` boolean: When true, usage policy reduced the response to visibility-safe fields.

## Other responses

- `400`: Bad Request
- `403`: The API key is missing, invalid or expired.
- `404`: Span not found.
- `429`: Rate Limited
- `500`: Internal Server Error

## Changes

- **2026-10-21** `c30bcb383ee8`: 24 breaking, 9 info
  - the response property `scores/additionalProperties/boolean_value` became nullable for the status `200`
  - the response property `scores/additionalProperties/categorical_value` became nullable for the status `200`
  - the response property `scores/additionalProperties/evaluator_name` became nullable for the status `200`
  - the response property `scores/additionalProperties/evaluator_slug` became nullable for the status `200`
  - …29 more
- **2026-10-02** `b830b79cfd52`: 1 warning, 3 info
  - removed the optional property `error` from the response with the `404` status
  - added the non-success response with the status `403`
  - removed the non-success response with the status `401`
  - added the required property `detail` to the response with the `404` status
- **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `RespanApiKey` was added to the API
- **2026-09-12** `22b868ef3f22`: 1 info
  - api operation id `retrieve-span` removed and replaced with `spans_retrieveSpan`
- …earlier changes not shown

[Operation history](https://skmtc.dev/keywordsai/apis/respan-api/changes/api/request-logs/:unique_id/get.md)

---

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