Home
New Relic
Trace Api Zipkin Span Structure
Trace Api Zipkin Span Structure
A single span in Zipkin JSON v2 format
Type: object
Properties: 11
Required: 2
Analysis Analytics APM DevOps Infrastructure Monitoring Observability Performance Platform
ZipkinSpan is a JSON Structure definition published by New Relic, describing 11 properties, of which 2 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
Properties
id
traceId
parentId
name
timestamp
duration
kind
localEndpoint
remoteEndpoint
tags
annotations
Meta-schema: https://json-structure.org/meta/core/v0/#
JSON Structure
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/new-relic/refs/heads/main/json-structure/trace-api-zipkin-span-structure.json",
"name": "ZipkinSpan",
"description": "A single span in Zipkin JSON v2 format",
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Span ID (16 hex characters)",
"example": "500123"
},
"traceId": {
"type": "string",
"description": "Trace ID (32 hex characters)",
"example": "500123"
},
"parentId": {
"type": "string",
"description": "Parent span ID",
"example": "500123"
},
"name": {
"type": "string",
"description": "Span name / operation name",
"example": "example-resource-01"
},
"timestamp": {
"type": "int32",
"description": "Span start time in microseconds since epoch",
"example": 1718153645993
},
"duration": {
"type": "int32",
"description": "Span duration in microseconds",
"example": 100
},
"kind": {
"type": "string",
"enum": [
"CLIENT",
"SERVER",
"PRODUCER",
"CONSUMER"
],
"example": "CLIENT"
},
"localEndpoint": {
"type": "object",
"properties": {
"serviceName": {
"type": "string"
},
"ipv4": {
"type": "string"
},
"port": {
"type": "int32"
}
},
"example": {
"serviceName": "myService",
"ipv4": "example_string",
"port": 8080
}
},
"remoteEndpoint": {
"type": "object",
"properties": {
"serviceName": {
"type": "string"
},
"ipv4": {
"type": "string"
},
"port": {
"type": "int32"
}
},
"example": {
"serviceName": "myService",
"ipv4": "example_string",
"port": 8080
}
},
"tags": {
"type": "object",
"additionalProperties": {
"type": "string"
},
"example": {
"customAttribute": "example_value"
}
},
"annotations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"type": "int32"
},
"value": {
"type": "string"
}
}
},
"example": [
{
"timestamp": 1718153645993,
"value": "example_string"
}
]
}
},
"required": [
"id",
"traceId"
]
}
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/trace-api-zipkin-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 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.