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

# Retrieve a span

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

Retrieve a span by its unique ID. Returns the full span including input, output, metrics, metadata, trace context, evaluation scores, and credit/budget info (`limit_info`).

## Path parameters

- `unique_id` string, required

## Headers

- `Authorization` string, required

## Response `200`

Successful response for Retrieve span

- SpansRetrieveSpanResponse200
  - `limit_info` ApiRequestLogsUniqueIdGetResponsesContentApplicationJsonSchemaLimitInfo
    - `is_allowed` boolean
    - `limits` ApiRequestLogsUniqueIdGetResponsesContentApplicationJsonSchemaLimitInfoLimitsItems[]
      - `name` string
      - `current_value` number, double
      - `new_value` number, double
      - `limit_value` number, double
      - `is_within_limit` boolean

## Other responses

- `400` — Bad Request
- `401` — Unauthorized - Missing/invalid authentication
- `404` — Not Found
- `429` — Rate Limited
- `500` — Internal Server Error

---

[API](https://skmtc.dev/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.dev/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keywordsai/api-reference/revisions/77d94e49bc7a/schema)