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 Metrics API

Metric data ingestion endpoints

New Relic Metrics 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 Metrics. 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 9 operations across 9 paths, and defines 14 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.

9 operations 9 paths 14 schemas 8 GET1 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 Metrics 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 9

Across 9 paths, the API surfaces 9 operations — 8 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Metrics 9

Metric data ingestion endpoints

POST
/metric/v1
New Relic Send Metric Data
sendMetrics 3 params body → 202400403413429
GET
/applications/{application_id}/hosts/{host_id}/metrics.json
New Relic Get Applications Hosts Host Metrics
getApplicationsIdHostsHostIdMetrics 5 params → 200
GET
/applications/{application_id}/hosts/{host_id}/metrics/data.json
New Relic Get Applications Hosts Host Metrics Data
getApplicationsIdHostsHostIdMetricsData 9 params → 200
GET
/applications/{application_id}/instances/{instance_id}/metrics.json
New Relic Get Applications Instances Instance Metrics
getApplicationsIdInstancesInstanceIdMetrics 5 params → 200
GET
/applications/{application_id}/instances/{instance_id}/metrics/data.json
New Relic Get Applications Instances Instance Metrics Data
getApplicationsIdInstancesInstanceIdMetricsData 9 params → 200
GET
/applications/{application_id}/metrics.json
New Relic Get Applications Metrics
getApplicationsIdMetrics 4 params → 200
GET
/applications/{application_id}/metrics/data.json
New Relic Get Applications Metrics Data
getApplicationsIdMetricsData 8 params → 200
GET
/mobile_applications/{mobile_application_id}/metrics.json
New Relic Get Mobile Applications Mobile Application Metrics
getMobileApplicationsMobileApplicationIdMetrics 4 params → 200
GET
/mobile_applications/{mobile_application_id}/metrics/data.json
New Relic Get Mobile Applications Mobile Application Metrics Data
getMobileApplicationsMobileApplicationIdMetricsData 8 params → 200

Schemas 14

The contract defines 14 schemas that model the data the API accepts and returns. The most detailed are MetricDataPoint (6 properties), MetricDataResponseType (5 properties), SummaryValue (4 properties), TimesliceResponse (3 properties). Each schema is shown below with its type and property counts.

MetricParserResponseType
object
2 properties
MetricListResponse
object
1 property
MetricPayload
array
An array of metric data objects to be ingested
TimesliceResponse
object
3 properties
MetricDataResponseType
object
5 properties
SummaryValue
object
Summary metric value containing statistical aggregations
4 properties 4 required
CommonBlock
object
Shared attributes applied to all metrics in this data object unless overridden at the metric level
3 properties
MetricResponse
object
2 properties
MetricDataPoint
object
A single metric data point
6 properties 3 required
ErrorResponse
object
Error response body
2 properties
MetricParserResponse
object
1 property
MetricDataObject
object
A container for a batch of metrics with optional shared attributes
2 properties 1 required
AcceptedResponse
object
Response returned when the payload was accepted
1 property
MetricDataResponse
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

new-relic-metrics-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