Netdata website screenshot

Netdata

Netdata is a real-time infrastructure monitoring and observability platform that collects per-second metrics from physical servers, virtual machines, cloud deployments, Kubernetes clusters, and IoT devices. It provides a REST API for querying metrics, alerts, and configuration on individual nodes (Agent API) as well as a Cloud API for programmatic access to Netdata Cloud resources including spaces, rooms, and nodes across distributed infrastructure. Authentication uses Bearer tokens generated from the Netdata Cloud account settings, with scopes controlling access to agent UI, Grafana plugin, MCP, and full API access. The platform includes AI-powered troubleshooting, role-based access control, and supports both cloud-hosted and on-premises deployments.

Netdata publishes 20 APIs on the APIs.io network, including Agent API, alerts API, authentication API, and 17 more. Tagged areas include Monitoring, Observability, Infrastructure, Metrics, and Alerts.

The Netdata catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

Netdata’s developer surface includes authentication, documentation, engineering blog, changelog, pricing, and 15 more developer resources.

57.9/100 strong ▬ flat Agent 44/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serveFree trial⚡ Free to try
20 APIs
MonitoringObservabilityInfrastructureMetricsAlertsReal-TimeAPMDevOps

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 57.9/100 · strong
Contract Quality 18.9 / 25
Developer Ergonomics 5.2 / 20
Commercial Clarity 11.6 / 20
Operational Transparency 7.5 / 13
Governance 8.3 / 12
Discoverability 6.5 / 10
Agent readiness — 44/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/netdata: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 20

Individual APIs this provider publishes, each with its own machine-readable definition.

Netdata Agent API

The Netdata Agent REST API provides access to metrics, alerts, and configuration on individual monitoring nodes. It supports v1, v2, and v3 endpoints for querying time-series da...

Netdata alerts API

Everything related to alerts

Netdata authentication API

The authentication API from Netdata — 5 operation(s) for authentication.

Netdata badges API

Everything related to dynamic badges based on metric data

Netdata charts API

Everything related to chart instances - DO NOT USE IN NEW CODE - use contexts instead

Netdata claiming API

The claiming API from Netdata — 2 operation(s) for claiming.

Netdata config API

The config API from Netdata — 1 operation(s) for config.

Netdata contexts API

Everything related contexts - in new code, use this instead of charts

Netdata data API

Everything related to data queries

Netdata dyncfg API

The dyncfg API from Netdata — 1 operation(s) for dyncfg.

Netdata functions API

Everything related to functions

Netdata management API

Everything related to managing netdata Agents

Netdata nodes API

Everything related to monitored nodes

Netdata registry API

The registry API from Netdata — 1 operation(s) for registry.

Netdata settings API

The settings API from Netdata — 1 operation(s) for settings.

Netdata streaming API

The streaming API from Netdata — 1 operation(s) for streaming.

Netdata variables API

The variables API from Netdata — 1 operation(s) for variables.

Netdata versions API

The versions API from Netdata — 1 operation(s) for versions.

Netdata webrtc API

The webrtc API from Netdata — 2 operation(s) for webrtc.

Netdata weights API

Everything related to scoring / weighting metrics

Scroll for all 20

Postman Collections 20

Ready-to-run Postman collections for exercising this provider's APIs.

Scroll for all 20

Pricing Plans 1

Published pricing tiers and plan structures.

Netdata Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Netdata Rate Limits

2 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Netdata Context

15 classes · 34 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Netdata API Rules

5 rules · 4 warnings 1 info

SPECTRAL

JSON Schema 3

Standalone JSON Schema definitions for this provider's data models.

Netdata Alert

13 properties

JSON SCHEMA

Netdata Chart

13 properties

JSON SCHEMA

Netdata Node

18 properties

JSON SCHEMA

Examples 4

Example request and response payloads for these APIs.

Netdata Alerts Example

5 fields

EXAMPLE

Netdata Data Query Example

19 fields

EXAMPLE

Netdata Node Info Example

20 fields

EXAMPLE

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Netdata Authentication

apiKey/http · 2 schemes

SECURITY

Netdata Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Netdata Trust Center

SOC 2, ISO 27001

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Netdata Agentic Access

79 operations · 12 acting

79 operations · 12 acting

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

Build 2

SDKs, sample code, and the tooling you integrate with

Access & Security 3

Authentication, authorization, and security posture

Operate 3

Status, limits, changes, and where to get help

Commercial 3

Pricing, plans, and the legal terms of use

Company 4

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: netdata
name: Netdata
description: Netdata is a real-time infrastructure monitoring and observability platform that collects per-second metrics
  from physical servers, virtual machines, cloud deployments, Kubernetes clusters, and IoT devices. It provides a REST API
  for querying metrics, alerts, and configuration on individual nodes (Agent API) as well as a Cloud API for programmatic
  access to Netdata Cloud resources including spaces, rooms, and nodes across distributed infrastructure. Authentication uses
  Bearer tokens generated from the Netdata Cloud account settings, with scopes controlling access to agent UI, Grafana plugin,
  MCP, and full API access. The platform includes AI-powered troubleshooting, role-based access control, and supports both
  cloud-hosted and on-premises deployments.
type: Index
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: true
  try_now: true
  public: false
  label: Freemium (free trial) · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/netdata.png
tags:
- Monitoring
- Observability
- Infrastructure
- Metrics
- Alerts
- Real-Time
- APM
- DevOps
url: https://raw.githubusercontent.com/api-evangelist/netdata/refs/heads/main/apis.yml
created: '2026-06-12'
modified: '2026-06-12'
specificationVersion: '0.19'
apis:
- aid: netdata:agent-api
  name: Netdata Agent API
  description: The Netdata Agent REST API provides access to metrics, alerts, and configuration on individual monitoring nodes.
    It supports v1, v2, and v3 endpoints for querying time-series data, health status, contexts, and system management. The
    API is documented via an OpenAPI/Swagger specification maintained in the official GitHub repository.
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - Monitoring
  - Metrics
  - Alerts
  - Nodes
  properties:
  - type: Documentation
    url: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  - type: OpenAPI
    url: https://raw.githubusercontent.com/netdata/netdata/master/src/web/api/netdata-swagger.yaml
  - type: OpenAPI
    url: openapi/netdata-agent-api-openapi.yml
  - type: JSONSchema
    url: json-schema/netdata-chart-schema.json
  - type: JSONSchema
    url: json-schema/netdata-alert-schema.json
  - type: JSONSchema
    url: json-schema/netdata-node-schema.json
  - type: Examples
    url: examples/netdata-charts-list-example.json
  - type: Examples
    url: examples/netdata-alerts-example.json
  - type: Examples
    url: examples/netdata-data-query-example.json
  - type: SwaggerUI
    url: https://learn.netdata.cloud/api
- aid: netdata:netdata-alerts-api
  name: Netdata alerts API
  description: Everything related to alerts
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - alerts
  properties:
  - type: OpenAPI
    url: openapi/netdata-alerts-api-openapi.yml
  - type: Documentation
    url: https://learn.netdata.cloud/docs/rest-api/api
  - type: Examples
    url: examples/netdata-node-info-example.json
  - type: SwaggerUI
    url: https://app.netdata.cloud/api/docs/
  - type: Authentication
    url: https://learn.netdata.cloud/docs/netdata-cloud/authentication-&-authorization/api-tokens
- aid: netdata:netdata-authentication-api
  name: Netdata authentication API
  description: The authentication API from Netdata — 5 operation(s) for authentication.
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - authentication
  properties:
  - type: OpenAPI
    url: openapi/netdata-authentication-api-openapi.yml
  - type: Documentation
    url: https://learn.netdata.cloud/docs/rest-api/api
  - type: Examples
    url: examples/netdata-node-info-example.json
  - type: SwaggerUI
    url: https://app.netdata.cloud/api/docs/
  - type: Authentication
    url: https://learn.netdata.cloud/docs/netdata-cloud/authentication-&-authorization/api-tokens
- aid: netdata:netdata-badges-api
  name: Netdata badges API
  description: Everything related to dynamic badges based on metric data
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - badges
  properties:
  - type: OpenAPI
    url: openapi/netdata-badges-api-openapi.yml
  - type: Documentation
    url: https://learn.netdata.cloud/docs/rest-api/api
  - type: Examples
    url: examples/netdata-node-info-example.json
  - type: SwaggerUI
    url: https://app.netdata.cloud/api/docs/
  - type: Authentication
    url: https://learn.netdata.cloud/docs/netdata-cloud/authentication-&-authorization/api-tokens
- aid: netdata:netdata-charts-api
  name: Netdata charts API
  description: Everything related to chart instances - DO NOT USE IN NEW CODE - use contexts instead
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - charts
  properties:
  - type: OpenAPI
    url: openapi/netdata-charts-api-openapi.yml
  - type: Documentation
    url: https://learn.netdata.cloud/docs/rest-api/api
  - type: Examples
    url: examples/netdata-node-info-example.json
  - type: SwaggerUI
    url: https://app.netdata.cloud/api/docs/
  - type: Authentication
    url: https://learn.netdata.cloud/docs/netdata-cloud/authentication-&-authorization/api-tokens
- aid: netdata:netdata-claiming-api
  name: Netdata claiming API
  description: The claiming API from Netdata — 2 operation(s) for claiming.
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - claiming
  properties:
  - type: OpenAPI
    url: openapi/netdata-claiming-api-openapi.yml
  - type: Documentation
    url: https://learn.netdata.cloud/docs/rest-api/api
  - type: Examples
    url: examples/netdata-node-info-example.json
  - type: SwaggerUI
    url: https://app.netdata.cloud/api/docs/
  - type: Authentication
    url: https://learn.netdata.cloud/docs/netdata-cloud/authentication-&-authorization/api-tokens
- aid: netdata:netdata-config-api
  name: Netdata config API
  description: The config API from Netdata — 1 operation(s) for config.
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - config
  properties:
  - type: OpenAPI
    url: openapi/netdata-config-api-openapi.yml
  - type: Documentation
    url: https://learn.netdata.cloud/docs/rest-api/api
  - type: Examples
    url: examples/netdata-node-info-example.json
  - type: SwaggerUI
    url: https://app.netdata.cloud/api/docs/
  - type: Authentication
    url: https://learn.netdata.cloud/docs/netdata-cloud/authentication-&-authorization/api-tokens
- aid: netdata:netdata-contexts-api
  name: Netdata contexts API
  description: Everything related contexts - in new code, use this instead of charts
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - contexts
  properties:
  - type: OpenAPI
    url: openapi/netdata-contexts-api-openapi.yml
  - type: Documentation
    url: https://learn.netdata.cloud/docs/rest-api/api
  - type: Examples
    url: examples/netdata-node-info-example.json
  - type: SwaggerUI
    url: https://app.netdata.cloud/api/docs/
  - type: Authentication
    url: https://learn.netdata.cloud/docs/netdata-cloud/authentication-&-authorization/api-tokens
- aid: netdata:netdata-data-api
  name: Netdata data API
  description: Everything related to data queries
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - data
  properties:
  - type: OpenAPI
    url: openapi/netdata-data-api-openapi.yml
  - type: Documentation
    url: https://learn.netdata.cloud/docs/rest-api/api
  - type: Examples
    url: examples/netdata-node-info-example.json
  - type: SwaggerUI
    url: https://app.netdata.cloud/api/docs/
  - type: Authentication
    url: https://learn.netdata.cloud/docs/netdata-cloud/authentication-&-authorization/api-tokens
- aid: netdata:netdata-dyncfg-api
  name: Netdata dyncfg API
  description: The dyncfg API from Netdata — 1 operation(s) for dyncfg.
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - dyncfg
  properties:
  - type: OpenAPI
    url: openapi/netdata-dyncfg-api-openapi.yml
  - type: Documentation
    url: https://learn.netdata.cloud/docs/rest-api/api
  - type: Examples
    url: examples/netdata-node-info-example.json
  - type: SwaggerUI
    url: https://app.netdata.cloud/api/docs/
  - type: Authentication
    url: https://learn.netdata.cloud/docs/netdata-cloud/authentication-&-authorization/api-tokens
- aid: netdata:netdata-functions-api
  name: Netdata functions API
  description: Everything related to functions
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - functions
  properties:
  - type: OpenAPI
    url: openapi/netdata-functions-api-openapi.yml
  - type: Documentation
    url: https://learn.netdata.cloud/docs/rest-api/api
  - type: Examples
    url: examples/netdata-node-info-example.json
  - type: SwaggerUI
    url: https://app.netdata.cloud/api/docs/
  - type: Authentication
    url: https://learn.netdata.cloud/docs/netdata-cloud/authentication-&-authorization/api-tokens
- aid: netdata:netdata-management-api
  name: Netdata management API
  description: Everything related to managing netdata Agents
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - management
  properties:
  - type: OpenAPI
    url: openapi/netdata-management-api-openapi.yml
  - type: Documentation
    url: https://learn.netdata.cloud/docs/rest-api/api
  - type: Examples
    url: examples/netdata-node-info-example.json
  - type: SwaggerUI
    url: https://app.netdata.cloud/api/docs/
  - type: Authentication
    url: https://learn.netdata.cloud/docs/netdata-cloud/authentication-&-authorization/api-tokens
- aid: netdata:netdata-nodes-api
  name: Netdata nodes API
  description: Everything related to monitored nodes
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - nodes
  properties:
  - type: OpenAPI
    url: openapi/netdata-nodes-api-openapi.yml
  - type: Documentation
    url: https://learn.netdata.cloud/docs/rest-api/api
  - type: Examples
    url: examples/netdata-node-info-example.json
  - type: SwaggerUI
    url: https://app.netdata.cloud/api/docs/
  - type: Authentication
    url: https://learn.netdata.cloud/docs/netdata-cloud/authentication-&-authorization/api-tokens
- aid: netdata:netdata-registry-api
  name: Netdata registry API
  description: The registry API from Netdata — 1 operation(s) for registry.
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - registry
  properties:
  - type: OpenAPI
    url: openapi/netdata-registry-api-openapi.yml
  - type: Documentation
    url: https://learn.netdata.cloud/docs/rest-api/api
  - type: Examples
    url: examples/netdata-node-info-example.json
  - type: SwaggerUI
    url: https://app.netdata.cloud/api/docs/
  - type: Authentication
    url: https://learn.netdata.cloud/docs/netdata-cloud/authentication-&-authorization/api-tokens
- aid: netdata:netdata-settings-api
  name: Netdata settings API
  description: The settings API from Netdata — 1 operation(s) for settings.
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - settings
  properties:
  - type: OpenAPI
    url: openapi/netdata-settings-api-openapi.yml
  - type: Documentation
    url: https://learn.netdata.cloud/docs/rest-api/api
  - type: Examples
    url: examples/netdata-node-info-example.json
  - type: SwaggerUI
    url: https://app.netdata.cloud/api/docs/
  - type: Authentication
    url: https://learn.netdata.cloud/docs/netdata-cloud/authentication-&-authorization/api-tokens
- aid: netdata:netdata-streaming-api
  name: Netdata streaming API
  description: The streaming API from Netdata — 1 operation(s) for streaming.
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - streaming
  properties:
  - type: OpenAPI
    url: openapi/netdata-streaming-api-openapi.yml
  - type: Documentation
    url: https://learn.netdata.cloud/docs/rest-api/api
  - type: Examples
    url: examples/netdata-node-info-example.json
  - type: SwaggerUI
    url: https://app.netdata.cloud/api/docs/
  - type: Authentication
    url: https://learn.netdata.cloud/docs/netdata-cloud/authentication-&-authorization/api-tokens
- aid: netdata:netdata-variables-api
  name: Netdata variables API
  description: The variables API from Netdata — 1 operation(s) for variables.
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - variables
  properties:
  - type: OpenAPI
    url: openapi/netdata-variables-api-openapi.yml
  - type: Documentation
    url: https://learn.netdata.cloud/docs/rest-api/api
  - type: Examples
    url: examples/netdata-node-info-example.json
  - type: SwaggerUI
    url: https://app.netdata.cloud/api/docs/
  - type: Authentication
    url: https://learn.netdata.cloud/docs/netdata-cloud/authentication-&-authorization/api-tokens
- aid: netdata:netdata-versions-api
  name: Netdata versions API
  description: The versions API from Netdata — 1 operation(s) for versions.
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - versions
  properties:
  - type: OpenAPI
    url: openapi/netdata-versions-api-openapi.yml
  - type: Documentation
    url: https://learn.netdata.cloud/docs/rest-api/api
  - type: Examples
    url: examples/netdata-node-info-example.json
  - type: SwaggerUI
    url: https://app.netdata.cloud/api/docs/
  - type: Authentication
    url: https://learn.netdata.cloud/docs/netdata-cloud/authentication-&-authorization/api-tokens
- aid: netdata:netdata-webrtc-api
  name: Netdata webrtc API
  description: The webrtc API from Netdata — 2 operation(s) for webrtc.
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - webrtc
  properties:
  - type: OpenAPI
    url: openapi/netdata-webrtc-api-openapi.yml
  - type: Documentation
    url: https://learn.netdata.cloud/docs/rest-api/api
  - type: Examples
    url: examples/netdata-node-info-example.json
  - type: SwaggerUI
    url: https://app.netdata.cloud/api/docs/
  - type: Authentication
    url: https://learn.netdata.cloud/docs/netdata-cloud/authentication-&-authorization/api-tokens
- aid: netdata:netdata-weights-api
  name: Netdata weights API
  description: Everything related to scoring / weighting metrics
  humanURL: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
  baseURL: http://localhost:19999
  tags:
  - weights
  properties:
  - type: OpenAPI
    url: openapi/netdata-weights-api-openapi.yml
  - type: Documentation
    url: https://learn.netdata.cloud/docs/rest-api/api
  - type: Examples
    url: examples/netdata-node-info-example.json
  - type: SwaggerUI
    url: https://app.netdata.cloud/api/docs/
  - type: Authentication
    url: https://learn.netdata.cloud/docs/netdata-cloud/authentication-&-authorization/api-tokens
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/netdata/overview
- type: AgenticAccess
  url: agentic-access/netdata-agentic-access.yml
- type: TrustCenter
  url: security/netdata-trust-center.yml
- type: DomainSecurity
  url: security/netdata-domain-security.yml
- type: Authentication
  url: authentication/netdata-authentication.yml
- type: Website
  url: https://www.netdata.cloud/
- type: Documentation
  url: https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
- type: GitHubOrganization
  url: https://github.com/netdata
- type: LinkedIn
  url: https://www.linkedin.com/company/netdata-cloud
- type: X
  url: https://x.com/netdatahq
- type: Blog
  url: https://www.netdata.cloud/blog/
- type: ChangeLog
  url: https://learn.netdata.cloud/docs/netdata-agent/changelog
- type: Pricing
  url: https://www.netdata.cloud/pricing/
- type: StatusPage
  url: https://status.netdata.cloud/
- type: Vocabulary
  url: vocabulary/netdata-vocabulary.yml
- type: JSONLDContext
  url: json-ld/netdata-context.jsonld
- type: Blog
  url: blogs/blogs.json
- type: Plans
  url: plans/netdata-plans-pricing.yml
- type: RateLimits
  url: rate-limits/netdata-rate-limits.yml
- type: FinOps
  url: finops/netdata-finops.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com