Introduction to New Relic APIs

New Relic offers a variety of APIs and SDKs you can use to:

Send data to New Relic.
Retrieve data from New Relic.
View and configure settings.

This document provides examples and reference information for our APIs.

APIs for data ingest

Our four primary data ingest APIs are some of the many solutions for reporting data to New Relic. These APIs can be used directly, but they're also the underlying ingest route for any of our tools that use those APIs (for example, our OpenTelemetry integration, or our Telemetry SDKs).

API type	Description
Metric API	Send dimensional metrics to New Relic from any source (including other telemetry monitoring services).
Event API	Send custom event data to New Relic without the use of an agent or integration.
Log API	Send log data to New Relic.
Trace API	Send distributed tracing data (also referred to as "spans") to New Relic without the use of an agent or integration.

NerdGraph (GraphQL)

NerdGraph is the API we recommend for querying New Relic data, querying account information, and making a range of feature configurations. To learn what you can do, check out the NerdGraph tutorials.

NerdGraph is our newest API and is our attempt to bring together in one place some of our older APIs, like our REST API. Note that there is still some functionality you can do with REST APIs that can't yet be done with NerdGraph, and this is why some New Relic organizations still use the REST API.

REST API

Our REST API is our older API for querying and configuration, which NerdGraph is in the process of replacing. The REST API has some configuration abilities that NerdGraph doesn't yet have, but when possible you should use NerdGraph. The REST API can be used for a wide range of features: for detail, see APIs by feature.

APIs by feature

New Relic tools and features, like APM, infrastructure monitoring, browser monitoring, and alerts, are often used together, and sometimes can overlap in functionality. This is why multiple APIs may be relevant to each area. Some API functionality will depend on your access to features and data.

API resources for application monitoring include:

Resource	Details
REST API	REST API features include: Retrieve APM data, including metrics, Apdex, error rates, and host data. Report deployments. Change the app name in the UI.
Agent APIs	Every APM language agent has an API that lets you customize the agent's default behavior, including reporting custom data. APM agent APIs include: C SDK API Go agent API Java agent API .NET agent API Node.js agent API PHP agent API Python agent API Ruby agent API
Query API	To query APM data, use NerdGraph.
Account management APIs	For APIs related to accounts and subscription usage, see the account-related APIs.

The browser API resources include:

Resource	Details
Browser agent API	Use the browser agent API for tasks such as: Report custom end user data to browser monitoring. Monitor asynchronous browser activity using SPA API calls. Insert custom data into New Relic dashboards . Manage source maps.
REST API	With the REST API you can: Retrieve page load timing data and throughput. Add or list apps monitored by browser monitoring. Manage alerts conditions for your browser data.
Query API	To query New Relic data, use NerdGraph.
Account management APIs	For APIs related to accounts and subscription usage, see the account-related APIs.

The Infrastructure API resources include:

Resource	Details
Query API	To query New Relic data, use NerdGraph.
Infrastructure alert API	To manage your infrastructure alerts, use the Infrastructure alert API.
Integrations SDK	To make your own custom integrations for reporting data to infrastructure monitoring, use the Integrations SDK.
NerdGraph	You can use NerdGraph (our GraphQL API) to query your cloud integration data and make changes to cloud integration settings.

Mobile API resources include:

Resource	Details
Mobile agent APIs	Mobile APIs let you custom instrument your own code and send events to New Relic. See the platform-specific documentation: iOS Android
REST API	Use the REST API for such tasks as: Retrieve a list of monitored apps. Get subscription usage data. Get metric names and data. Get crash count and crash rate data. Manage New Relic alerts conditions for your mobile apps.
Query API	To query New Relic data, use NerdGraph.
Account management APIs	For account-related APIs, see Account APIs.

Synthetics API resources include:

Resource	Details
Synthetics REST API	The Synthetics REST API functionality includes: Create and manage synthetics monitors. Manage synthetics alert notifications. Add labels to monitors, and retrieve monitors with specific labels.
Query API	To query New Relic data, use NerdGraph.
Alerts API	To create and manage alert conditions that target synthetics monitors, use the alerts API.

Resource

Details

Synthetics REST API

The Synthetics REST API functionality includes:

Query API

To query New Relic data, use NerdGraph.

Alerts API

To create and manage alert conditions that target synthetics monitors, use the alerts API.

Account management, admin, and usage APIs

Like any other New Relic product or service, you want to be confident that your APIs protect you and your customers' data privacy. The following are API resources related to New Relic account administration and usage.

For more information about API capabilities, see the specific New Relic API. For more information about New Relic's security measures, see our security and privacy documentation, or visit the New Relic security website.

Resource	Details
REST API	REST API features include: Find your API keys, account ID, and information needed to use the REST API. Return a list of account users (original user model only). Get SLA report data for browser and application monitoring.
Subscription usage (original pricing model)	For organizations on our original pricing model, you can use NerdGraph to query subscription usage data. This can be helpful to see how usage compares to your current subscription level, or for doing departmental chargebacks.
Partner API	If you're a New Relic partnership organization, you can use the Partner API to retrieve data and make configurations.

Resource

Details

REST API

REST API features include:

Find your API keys, account ID, and information needed to use the REST API.
Return a list of account users (original user model only).
Get SLA report data for browser and application monitoring.

Subscription usage (original pricing model)

For organizations on our original pricing model, you can use NerdGraph to query subscription usage data. This can be helpful to see how usage compares to your current subscription level, or for doing departmental chargebacks.

Partner API

If you're a New Relic partnership organization, you can use the Partner API to retrieve data and make configurations.

Other APIs

New Relic Insights was the name of our original product that governed custom event reporting and querying. The features associated with Insights have been rolled into our New Relic One platform (learn more), but there are still some APIs and original pricing models that use the term "Insights" for these historical reasons.

Insights-related APIs include:

Resource	Details
Event API	To report custom events, use the Event API.
Query API	Our Insights Query API is mostly deprecated. Instead, use NerdGraph for querying your New Relic data.

APIs for data ingest

NerdGraph (GraphQL)

REST API

APIs by feature

Alerts

APM

Browser monitoring

Infrastructure monitoring

Mobile monitoring

Synthetic monitoring

Account management, admin, and usage APIs

Other APIs

Insights