---
title: "Serve the last complete exact attribute snapshot and refresh out of band."
method: GET
path: "/api/traces/span-attribute-detail/"
tags: ["api"]
---

# Serve the last complete exact attribute snapshot and refresh out of band.

`GET /api/traces/span-attribute-detail/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/api/traces/span-attribute-detail/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

GET /api/traces/span-attribute-detail/?project_id=<uuid>&key=<attr_key>

## Query parameters

- `project_id` string, uuid, required
- `key` string, required
- `refresh` boolean

## Response `200`

OK

- SpanAttributeDetailResponse
  - `key` string, required
  - `type` 'string' | 'number' | 'boolean' | 'array' | 'map' | 'json', nullable, required
  - `count` integer, required
  - `unique_values` integer
  - `types` SpanAttributeTypeSummary[]
    - `type` 'string' | 'number' | 'boolean' | 'array' | 'map' | 'json', required
    - `count` integer, required
    - `unique_values` integer, required
  - `top_values` SpanAttributeTopValue[]
    - `value` object, nullable, required: Any valid JSON value.
    - `type` 'string' | 'number' | 'boolean' | 'array' | 'map' | 'json'
    - `count` integer, required
    - `percentage` number, required
  - `min` number, nullable
  - `max` number, nullable
  - `avg` number, nullable
  - `p50` number, nullable
  - `p95` number, nullable
  - `stats` SpanAttributeNumericStats
    - `min` number, nullable
    - `max` number, nullable
    - `avg` number, nullable
    - `p50` number, nullable
    - `p95` number, nullable
  - `query_complete` boolean, required
  - `query_status` 'complete' | 'pending' | 'sampled' | 'degraded', required
  - `query_sampled` boolean, required
  - `query_error_code` 'sample_limit' | 'read_budget_exceeded' | 'query_failed'
  - `query_window_start` string, date-time
  - `query_window_end` string, date-time
  - `query_count` integer
  - `query_elapsed_ms` number
  - `query_completed_at` string, date-time
  - `query_cached` boolean
  - `query_refreshing` boolean
  - `query_refresh_failed` boolean

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Service Unavailable
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)