Skip to main content
GET
https://api.app.shinzo.ai
/
telemetry
/
fetch_spans
Fetch Spans
curl --request GET \
  --url https://api.app.shinzo.ai/telemetry/fetch_spans \
  --header 'Authorization: Bearer <token>'

​
Authentication

Requires JWT token authentication. 
Authorization: Bearer <jwt_token>

​
Query Parameters

​
start_date
string
Filter by start date (ISO 8601)
​
end_date
string
Filter by end date (ISO 8601)
​
resource_id
string
Filter by resource ID
​
service_name
string
Filter by service name
​
trace_id
string
Filter by trace ID
​
limit
number
Max results to return
​
offset
number
Pagination offset
​
sort
string
Sort field
​
sort_direction
string
Sort direction (asc, desc)

​
Example Request

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

​
Response

{
  "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

CodeDescription
200Success
400Invalid query parameters
401Invalid or missing token