> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shinzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch Spans

> Get individual spans with optional filtering.

## Authentication

Requires JWT token authentication.

```bash theme={null}
Authorization: Bearer <jwt_token>
```

## Query Parameters

<ParamField query="start_date" type="string">Filter by start date (ISO 8601)</ParamField>
<ParamField query="end_date" type="string">Filter by end date (ISO 8601)</ParamField>
<ParamField query="resource_id" type="string">Filter by resource ID</ParamField>
<ParamField query="service_name" type="string">Filter by service name</ParamField>
<ParamField query="trace_id" type="string">Filter by trace ID</ParamField>
<ParamField query="limit" type="number">Max results to return</ParamField>
<ParamField query="offset" type="number">Pagination offset</ParamField>
<ParamField query="sort" type="string">Sort field</ParamField>
<ParamField query="sort_direction" type="string">Sort direction (`asc`, `desc`)</ParamField>

## Example Request

```bash theme={null}
curl -X GET "https://api.app.shinzo.ai/telemetry/fetch_spans?trace_id=5b8aa5a2d2c872e8321cf37308d69df2" \
  -H "Authorization: Bearer <jwt_token>"
```

## Response

```json theme={null}
{
  "spans": [
    {
      "span_id": "051581bf3cb55c13",
      "trace_id": "5b8aa5a2d2c872e8321cf37308d69df2",
      "parent_span_id": null,
      "name": "mcp.tool.execute",
      "kind": "internal",
      "start_time": "2025-01-20T14:30:00.000Z",
      "end_time": "2025-01-20T14:30:00.125Z",
      "duration_ms": 125,
      "status": "ok",
      "attributes": {
        "mcp.tool.name": "search_files",
        "mcp.tool.duration": 125
      }
    }
  ],
  "pagination": {
    "total": 3,
    "limit": 50,
    "offset": 0
  }
}
```

## Status Codes

| Code  | Description              |
| ----- | ------------------------ |
| `200` | Success                  |
| `400` | Invalid query parameters |
| `401` | Invalid or missing token |