Zipkin · JSON Structure

Zipkin Api V2 Span Structure

A Zipkin span representing an individual unit of work in a distributed trace.

Type: object Properties: 13 Required: 2
Distributed TracingObservabilityOpen-SourceMicroservices

Span is a JSON Structure definition published by Zipkin, describing 13 properties, of which 2 are required. It conforms to the https://json-structure.org/schema/v0 meta-schema.

Properties

traceId parentId id kind name timestamp duration localEndpoint remoteEndpoint annotations tags debug shared

Meta-schema: https://json-structure.org/schema/v0

JSON Structure

Raw ↑ 
{
  "$schema": "https://json-structure.org/schema/v0",
  "name": "Span",
  "type": "object",
  "description": "A Zipkin span representing an individual unit of work in a distributed trace.",
  "properties": {
    "traceId": {"type": "string", "description": "128-bit or 64-bit trace ID, hex encoded"},
    "parentId": {"type": "string", "description": "Parent span ID, hex encoded"},
    "id": {"type": "string", "description": "64-bit span ID, hex encoded"},
    "kind": {"type": "string", "enum": ["CLIENT", "SERVER", "PRODUCER", "CONSUMER"]},
    "name": {"type": "string", "description": "Logical operation name"},
    "timestamp": {"type": "integer", "description": "Start epoch microseconds"},
    "duration": {"type": "integer", "description": "Duration in microseconds"},
    "localEndpoint": {"$ref": "zipkin-api-v2-endpoint-structure.json"},
    "remoteEndpoint": {"$ref": "zipkin-api-v2-endpoint-structure.json"},
    "annotations": {"type": "array", "items": {"$ref": "zipkin-api-v2-annotation-structure.json"}},
    "tags": {"type": "map", "values": {"type": "string"}},
    "debug": {"type": "boolean"},
    "shared": {"type": "boolean"}
  },
  "required": ["traceId", "id"]
}

Work with this as data

Every JSON Structure 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 json structure

4 MCP tools reach this
  • find_json_structuresBrowse and filter every JSON Structure in the catalog.
  • 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.
All 92 tools

Call it yourself

curl for this page
This JSON Structure 
curl "https://apis.io/api/v1/json-structures/zipkin-api-v2-span-structure"
All json structure 
curl "https://apis.io/api/v1/json-structures?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.