# Netdata Agent API

**Canonical:** https://apis.io/apis/netdata/agent-api/  
**Provider:** Netdata — https://apis.io/providers/netdata/  
**Base URL:** http://localhost:19999  
**Documentation:** https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api

Netdata Agent API is one of 20 APIs that [Netdata](https://apis.io/providers/netdata/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 3 JSON Schema definitions. Tagged areas include Monitoring, Metrics, Alerts, and Nodes. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, and 3 JSON Schemas.

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.

## Machine-readable artifacts (11)

- **Documentation** — https://learn.netdata.cloud/docs/developer-and-contributor-corner/rest-api
- **OpenAPI** — https://raw.githubusercontent.com/netdata/netdata/master/src/web/api/netdata-swagger.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/netdata/refs/heads/main/openapi/netdata-agent-api-openapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/netdata/refs/heads/main/json-schema/netdata-chart-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/netdata/refs/heads/main/json-schema/netdata-alert-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/netdata/refs/heads/main/json-schema/netdata-node-schema.json
- **Examples** — https://raw.githubusercontent.com/api-evangelist/netdata/refs/heads/main/examples/netdata-charts-list-example.json
- **Examples** — https://raw.githubusercontent.com/api-evangelist/netdata/refs/heads/main/examples/netdata-alerts-example.json
- **Examples** — https://raw.githubusercontent.com/api-evangelist/netdata/refs/heads/main/examples/netdata-data-query-example.json
- **SwaggerUI** — https://learn.netdata.cloud/api
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/netdata/refs/heads/main/apis.yml

## Other Netdata APIs (12)

- [Netdata alerts API](https://apis.io/apis/netdata/netdata-alerts-api/)
- [Netdata authentication API](https://apis.io/apis/netdata/netdata-authentication-api/)
- [Netdata badges API](https://apis.io/apis/netdata/netdata-badges-api/)
- [Netdata charts API](https://apis.io/apis/netdata/netdata-charts-api/)
- [Netdata claiming API](https://apis.io/apis/netdata/netdata-claiming-api/)
- [Netdata config API](https://apis.io/apis/netdata/netdata-config-api/)
- [Netdata contexts API](https://apis.io/apis/netdata/netdata-contexts-api/)
- [Netdata data API](https://apis.io/apis/netdata/netdata-data-api/)
- [Netdata dyncfg API](https://apis.io/apis/netdata/netdata-dyncfg-api/)
- [Netdata functions API](https://apis.io/apis/netdata/netdata-functions-api/)
- [Netdata management API](https://apis.io/apis/netdata/netdata-management-api/)
- [Netdata nodes API](https://apis.io/apis/netdata/netdata-nodes-api/)

## Tags

Monitoring, Metrics, Alerts, Nodes

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/netdata/agent-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/netdata/.