Jaeger Traces API
Endpoints for searching and retrieving distributed traces.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/jaeger-traces-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Jaeger Query Dependencies Traces API
description: The Jaeger Query API provides HTTP endpoints for retrieving trace data, service information, operations, and dependency graphs from the Jaeger distributed tracing backend. This API is exposed by the jaeger-query component and is used by the Jaeger UI and other clients to search and retrieve distributed traces collected across microservices.
version: 1.0.0
contact:
name: Jaeger Project
url: https://www.jaegertracing.io/
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0
servers:
- url: http://localhost:16686
description: Default Jaeger Query server
tags:
- name: Traces
description: Endpoints for searching and retrieving distributed traces.
paths:
/api/traces:
get:
operationId: searchTraces
summary: Search traces
description: Search for traces matching the specified query parameters. Returns a list of traces filtered by service, operation, tags, duration, and time range.
tags:
- Traces
parameters:
- name: service
in: query
description: The service name to filter traces by.
required: true
schema:
type: string
- name: operation
in: query
description: The operation name to filter traces by.
schema:
type: string
- name: tags
in: query
description: Tags to filter by in JSON format, e.g. {"http.status_code":"200"}.
schema:
type: string
- name: start
in: query
description: Start time as Unix microseconds.
schema:
type: integer
format: int64
- name: end
in: query
description: End time as Unix microseconds.
schema:
type: integer
format: int64
- name: minDuration
in: query
description: Minimum trace duration filter, specified as a duration string (e.g. 1.2s, 100ms, 500us).
schema:
type: string
- name: maxDuration
in: query
description: Maximum trace duration filter, specified as a duration string (e.g. 1.2s, 100ms, 500us).
schema:
type: string
- name: limit
in: query
description: Maximum number of traces to return.
schema:
type: integer
default: 20
- name: lookback
in: query
description: How far back to search for traces, specified as a duration string (e.g. 1h, 2d). Only used if start and end are not set.
schema:
type: string
responses:
'200':
description: A list of matching traces.
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Trace'
total:
type: integer
description: Total number of matching traces.
limit:
type: integer
description: Limit applied to the query.
offset:
type: integer
description: Offset applied to the query.
errors:
type: array
items:
$ref: '#/components/schemas/StructuredError'
'400':
description: Invalid query parameters.
'500':
description: Internal server error.
/api/traces/{traceID}:
get:
operationId: getTrace
summary: Get a trace by ID
description: Retrieve a single trace by its unique trace identifier.
tags:
- Traces
parameters:
- name: traceID
in: path
required: true
description: The trace ID in hexadecimal format (16 or 32 hex characters).
schema:
type: string
- name: raw
in: query
description: Return raw trace data without post-processing.
schema:
type: boolean
default: false
- name: prettyPrint
in: query
description: Pretty-print the JSON response.
schema:
type: boolean
default: false
responses:
'200':
description: The requested trace.
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Trace'
errors:
type: array
items:
$ref: '#/components/schemas/StructuredError'
'404':
description: Trace not found.
'500':
description: Internal server error.
components:
schemas:
Span:
type: object
description: A span represents a single unit of work within a trace. Spans have a start time, duration, and contain metadata about the operation being performed.
properties:
traceID:
type: string
description: The trace ID this span belongs to.
spanID:
type: string
description: Unique span identifier in hexadecimal format.
operationName:
type: string
description: The name of the operation this span represents.
references:
type: array
description: References to other spans (parent or follows-from).
items:
$ref: '#/components/schemas/SpanReference'
flags:
type: integer
description: Span flags for sampling and other options.
startTime:
type: integer
format: int64
description: Start time of the span in Unix microseconds.
duration:
type: integer
format: int64
description: Duration of the span in microseconds.
tags:
type: array
description: Key-value pairs providing additional span metadata.
items:
$ref: '#/components/schemas/KeyValue'
logs:
type: array
description: Time-stamped log entries associated with this span, used to record events during the span lifecycle.
items:
$ref: '#/components/schemas/SpanLog'
processID:
type: string
description: Reference to the process that produced this span, corresponding to a key in the trace-level processes map.
warnings:
type: array
description: Warnings generated for this span.
items:
type: string
required:
- traceID
- spanID
- operationName
- startTime
- duration
KeyValue:
type: object
description: A typed key-value pair used for span tags and log fields.
properties:
key:
type: string
description: The key name.
type:
type: string
description: The value type.
enum:
- string
- bool
- int64
- float64
- binary
value:
description: The value, type depends on the type field.
required:
- key
- type
- value
SpanReference:
type: object
description: A reference from one span to another, establishing causal relationships within a trace.
properties:
refType:
type: string
description: The type of reference.
enum:
- CHILD_OF
- FOLLOWS_FROM
traceID:
type: string
description: The trace ID of the referenced span.
spanID:
type: string
description: The span ID of the referenced span.
required:
- refType
- traceID
- spanID
StructuredError:
type: object
description: A structured error returned by the API.
properties:
code:
type: integer
description: Error code.
msg:
type: string
description: Error message.
traceID:
type: string
description: Trace ID associated with the error, if applicable.
Process:
type: object
description: A process represents the service instance that produced spans.
properties:
serviceName:
type: string
description: The name of the service.
tags:
type: array
description: Additional metadata about the process.
items:
$ref: '#/components/schemas/KeyValue'
required:
- serviceName
Trace:
type: object
description: A trace represents the complete journey of a request through a distributed system. It consists of one or more spans forming a directed acyclic graph.
properties:
traceID:
type: string
description: Unique trace identifier in hexadecimal format (16 or 32 hex characters).
spans:
type: array
description: The spans that make up this trace.
items:
$ref: '#/components/schemas/Span'
processes:
type: object
description: Map of process IDs to process objects. Processes represent the services that produced spans in this trace.
additionalProperties:
$ref: '#/components/schemas/Process'
warnings:
type: array
description: Warnings generated during trace retrieval.
items:
type: string
required:
- traceID
- spans
- processes
SpanLog:
type: object
description: A time-stamped log entry within a span.
properties:
timestamp:
type: integer
format: int64
description: Timestamp of the log entry in Unix microseconds.
fields:
type: array
description: Key-value pairs representing the log data.
items:
$ref: '#/components/schemas/KeyValue'
required:
- timestamp
- fields