Fetch Spans
curl --request GET \
--url https://api.app.shinzo.ai/telemetry/fetch_spans \
--header 'Authorization: Bearer <token>'Telemetry
Fetch Spans
Get individual spans with optional filtering.
GET
/
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
string
Filter by start date (ISO 8601)
string
Filter by end date (ISO 8601)
string
Filter by resource ID
string
Filter by service name
string
Filter by trace ID
number
Max results to return
number
Pagination offset
string
Sort field
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
| Code | Description |
|---|---|
200 | Success |
400 | Invalid query parameters |
401 | Invalid or missing token |

