Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

New Relic Traces API

Distributed trace span ingestion

New Relic Traces API is one of 41 APIs that New Relic publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 111 JSON Schema definitions.

Tagged areas include Traces. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, an API reference, a JSON-LD context, rate-limit docs, and 111 JSON Schemas.

This API exposes 1 operation across 1 path, and defines 8 schemas. It is described by OpenAPI 3.1.0, at version 1.

Requests are made against 2 base URLs: https://insights-collector.newrelic.com, https://insights-collector.eu01.nr-data.net.

1 operations 1 paths 8 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1
Base URL
https://api.newrelic.com/v2/
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

New Relic Traces API declares 1 security scheme for authenticating requests. An API key is passed in the header as Api-Key (apiKey). By default, every request must be authenticated.

  • apiKey — New Relic License Key or Ingest API Key

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

Traces 1

Distributed trace span ingestion

POST
/trace/v1
New Relic Send Trace Spans
sendTraces 4 params body → 202400403413429

Schemas 8

The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are ZipkinSpan (11 properties), Span (4 properties), ErrorResponse (2 properties), SpanBatch (2 properties). Each schema is shown below with its type and property counts.

SpanBatch
object
A batch of spans with optional shared attributes
2 properties 1 required
Span
object
A single distributed trace span in New Relic format
4 properties 2 required
CommonBlock
object
Shared attributes applied to all spans in this batch
1 property
ZipkinSpan
object
A single span in Zipkin JSON v2 format
11 properties 2 required
ZipkinTracePayload
array
Zipkin JSON v2 format trace payload
ErrorResponse
object
2 properties
AcceptedResponse
object
1 property
NewRelicTracePayload
array
New Relic format trace payload — array of span batch objects

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

new-relic-traces-api-openapi.yml Raw ↑

Other APIs New Relic publishes across the network.

New Relic NerdGraph API
New Relic Alerts API
New Relic Synthetics API
New Relic Infrastructure Alerts API
New Relic Browser API
New Relic Partnership API
New Relic Telemetry SDKs
New Relic OpenTelemetry OTLP Endpoint
New Relic Control
New Relic NRQL Lookups API
New Relic Security Data API
New Relic Mobile SDK