Fetch Traces

Get traces with optional filtering.

GET /telemetry/fetch_traces

Fetch Traces

cURL

curl --request GET \
  --url https://api.app.shinzo.ai/telemetry/fetch_traces \
  --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

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_traces?service_name=my-mcp-server&limit=50" \
  -H "Authorization: Bearer <jwt_token>"

Response

{
  "traces": [
    {
      "trace_id": "5b8aa5a2d2c872e8321cf37308d69df2",
      "service_name": "my-mcp-server",
      "root_span_name": "mcp.tool.execute",
      "duration_ms": 125,
      "status": "ok",
      "span_count": 3,
      "timestamp": "2025-01-20T14:30:00Z"
    }
  ],
  "pagination": {
    "total": 150,
    "limit": 50,
    "offset": 0
  }
}

Status Codes

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