Retrieve a trace | Respan Docs

curl -G https://api.respan.ai/api/traces/trace_unique_id/ \
     -H "Authorization: Bearer sk_live_xxxxx" \
     -H "Content-Type: application/json" \
     -d environment=production

{
  "trace_id": "a3f5c9d2-7b4e-4f1a-9c3e-2d8b7f6a1e4c",
  "root_span": {
    "span_id": "1a2b3c4d5e6f7g8h",
    "operation_name": "HTTP GET /api/user/profile",
    "start_time": "2024-06-01T12:00:00.123Z",
    "end_time": "2024-06-01T12:00:00.456Z",
    "input": {
      "headers": {
        "Authorization": "Bearer sk_live_abcdef1234567890",
        "Accept": "application/json"
      },
      "query_params": {
        "user_id": "12345"
      }
    },
    "output": {
      "status_code": 200,
      "body": {
        "user": {
          "id": "12345",
          "name": "Jane Doe",
          "email": "jane.doe@example.com"
        }
      }
    },
    "children": [
      {
        "span_id": "2b3c4d5e6f7g8h9i",
        "operation_name": "DB Query: SELECT user",
        "start_time": "2024-06-01T12:00:00.130Z",
        "end_time": "2024-06-01T12:00:00.200Z",
        "input": {
          "query": "SELECT * FROM users WHERE id = 12345"
        },
        "output": {
          "rows_returned": 1
        },
        "children": []
      },
      {
        "span_id": "3c4d5e6f7g8h9i0j",
        "operation_name": "Cache Lookup: user_profile",
        "start_time": "2024-06-01T12:00:00.210Z",
        "end_time": "2024-06-01T12:00:00.215Z",
        "input": {
          "cache_key": "user_profile_12345"
        },
        "output": {
          "cache_hit": true
        },
        "children": []
      }
    ]
  }
}

Retrieve a trace by its ID, including the complete span tree with full input/output for all spans.

Path parameters

trace_unique_idstringRequired

Trace Unique Id

Query parameters

environmentstringOptional

Filter by environment.

start_timedatetimeOptional

Start of time range (ISO 8601).

end_timedatetimeOptional

End of time range (ISO 8601).

Response

Successful response for Retrieve trace

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

Path parameters

Headers

Query parameters

Response

Errors