Fetch Traces

curl --request GET \
  --url https://api.app.shinzo.ai/telemetry/fetch_traces \
  --header 'Authorization: Bearer <token>'

GET

telemetry

fetch_traces

Fetch Traces

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

string

Filter by start date (ISO 8601)

string

Filter by end date (ISO 8601)

string

Filter by resource ID

string

Filter by service name

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_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

Overview

Authentication

AI Agents

Agent Messaging

Agent Schedules & Triggers

Agent Channels

Agent Filesystem

MCP Servers

Spotlight

Tokens

Provider Keys

Telemetry

Fetch Traces

Authentication

Query Parameters

Example Request

Response

Status Codes

​Authentication

​Query Parameters

​Example Request

​Response

​Status Codes

Authentication

Query Parameters

Example Request

Response

Status Codes