Nagios

aid: nagios
name: Nagios
description: >-
  Nagios is a family of open-source and commercial IT infrastructure monitoring tools, including Nagios Core (the
  original open-source monitoring engine), Nagios XI (the commercial enterprise distribution), Nagios Fusion, Nagios Log
  Server, and Nagios Network Analyzer, used to monitor hosts, services, networks, applications, and metrics with
  alerting and reporting. Nagios Core itself has no central HTTP API; Nagios XI ships a built-in REST API (typically
  reached at https://{nagios-xi-host}/nagiosxi/api/v1/) for reading, writing, deleting, and updating monitoring
  configuration and status. The Nagios XI API is authenticated via a per-user API key passed as a query parameter or
  header. Passive check results can also be submitted via NRDP (HTTP, JSON/XML) or NSCA (encrypted TCP, port 5667), and
  the NCPA cross-platform agent exposes a hierarchical REST API on port 5693.
type: Index
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
  - Monitoring
  - Infrastructure Monitoring
  - Network Monitoring
  - Open Source
  - IT Operations
  - Alerting
  - Observability
  - Nagios XI
  - Nagios Core
  - NCPA
  - NRPE
  - NSCA
  - NRDP
url: https://raw.githubusercontent.com/api-evangelist/nagios/refs/heads/main/apis.yml
created: '2026-05-11'
modified: '2026-05-23'
specificationVersion: '0.19'
apis:
  - aid: nagios:xi-rest-api
    name: Nagios XI REST API
    description: >-
      Built-in REST API for Nagios XI. Split into three sections: Objects (read-only backend for hosts, services, host
      groups, contacts, downtime, history), Config (admin-only writes for hosts and services), and System (admin-only
      commands such as apply configuration, scheduled downtime, status). Responses are returned as JSON. Authentication
      uses a per-user Nagios XI API key passed via the `apikey` query parameter (or header). Custom endpoints can be
      added by creating a Nagios XI Component.
    humanURL: https://support.nagios.com/kb/article/nagios-xi-rest-api-176.html
    baseURL: https://{nagios-xi-host}/nagiosxi/api/v1
    tags:
      - Monitoring
      - REST
      - Nagios XI
      - IT Operations
    properties:
      - type: Documentation
        url: https://support.nagios.com/kb/article/nagios-xi-rest-api-176.html
      - type: API PDF Guide
        url: https://assets.nagios.com/downloads/nagiosxi/docs/Accessing-and-Using-the-XI-REST-API.pdf
      - type: Backend API
        url: https://assets.nagios.com/downloads/nagiosxi/docs/Accessing_The_XI_Backend_API.pdf
      - type: Automated Host Management
        url: https://assets.nagios.com/downloads/nagiosxi/docs/Automated_Host_Management.pdf
      - type: OpenAPI
        url: openapi/nagios-xi-openapi.yml
      - type: JSONSchema
        url: json-schema/nagios-xi-host-schema.json
      - type: JSONSchema
        url: json-schema/nagios-xi-service-schema.json
      - type: JSONStructure
        url: json-structure/nagios-xi-host-structure.json
      - type: SpectralRules
        url: rules/nagios-xi-rules.yml
  - aid: nagios:ncpa-api
    name: NCPA (Nagios Cross-Platform Agent) API
    description: >-
      REST API exposed by the Nagios Cross-Platform Agent (NCPA), a cross-platform monitoring agent that runs on Linux,
      Windows, and macOS. Uses a hierarchical URL structure `/api/{module}/{node1}/{node2}` for CPU, memory, disk,
      interface, process, service, and plugin metrics. Both active polling and passive Nagios-style check results
      (`check=1` + thresholds) are supported. Authenticated via a `token` query parameter matching the
      `community_string` in the agent config. Default TLS port 5693.
    humanURL: https://www.nagios.org/ncpa/help/3.x/api.html
    baseURL: https://{ncpa-host}:5693/api
    tags:
      - Monitoring
      - Agent
      - REST
      - NCPA
    properties:
      - type: Documentation
        url: https://www.nagios.org/ncpa/help/3.x/api.html
      - type: GitHub
        url: https://github.com/NagiosEnterprises/ncpa
      - type: OpenAPI
        url: openapi/ncpa-openapi.yml
      - type: JSONSchema
        url: json-schema/ncpa-metric-schema.json
      - type: SpectralRules
        url: rules/ncpa-rules.yml
  - aid: nagios:nrdp-api
    name: NRDP (Nagios Remote Data Processor) API
    description: >-
      PHP-based HTTP collector that accepts passive check results and external commands. Two commands are supported:
      `submitcheck` (host/service check results) and `submitcmd` (Nagios external command). Payloads can be sent as XML
      (`XMLDATA`) or JSON (`JSONDATA`) in a POST form. Authenticated by a token configured in `config.inc.php` with
      optional per-command deny mappings.
    humanURL: https://github.com/NagiosEnterprises/nrdp
    baseURL: https://{nrdp-host}/nrdp
    tags:
      - Monitoring
      - Passive Check
      - REST
      - NRDP
    properties:
      - type: GitHub
        url: https://github.com/NagiosEnterprises/nrdp
      - type: OpenAPI
        url: openapi/nrdp-openapi.yml
      - type: JSONSchema
        url: json-schema/nagios-check-result-schema.json
      - type: JSONStructure
        url: json-structure/nagios-check-result-structure.json
  - aid: nagios:nsca
    name: NSCA (Nagios Service Check Acceptor)
    description: >-
      Encrypted binary TCP daemon (default port 5667) that accepts passive service/host check results from remote
      machines. Not REST — clients send tab-delimited records over a shared-secret-encrypted socket. Use NRDP for an
      HTTP/JSON equivalent.
    humanURL: https://github.com/NagiosEnterprises/nsca
    baseURL: tcp://{nsca-host}:5667
    tags:
      - Monitoring
      - Passive Check
      - Binary Protocol
      - NSCA
    properties:
      - type: GitHub
        url: https://github.com/NagiosEnterprises/nsca
  - aid: nagios:nrpe
    name: NRPE (Nagios Remote Plugin Executor)
    description: >-
      Daemon that runs Nagios plugins on a remote Linux/Unix host on TCP port 5666, returning the plugin's exit code and
      output to the Nagios server. Binary protocol, not REST.
    humanURL: https://github.com/NagiosEnterprises/nrpe
    baseURL: tcp://{nrpe-host}:5666
    tags:
      - Monitoring
      - Active Check
      - Binary Protocol
      - NRPE
    properties:
      - type: GitHub
        url: https://github.com/NagiosEnterprises/nrpe
common:
  - type: Website
    url: https://www.nagios.org
  - type: Nagios XI Website
    url: https://www.nagios.com/products/nagios-xi/
  - type: Documentation
    url: https://www.nagios.org/documentation/
  - type: NagiosLibrary
    url: https://library.nagios.com/docs/
  - type: Support Knowledgebase
    url: https://support.nagios.com/kb/
  - type: Pricing
    url: https://www.nagios.com/products/pricing/
  - type: Downloads
    url: https://www.nagios.org/downloads/
  - type: NagiosExchange
    url: https://exchange.nagios.org/
  - type: GitHubOrganization
    url: https://github.com/NagiosEnterprises
  - type: SourceRepo
    url: https://github.com/NagiosEnterprises/nagioscore
  - type: SourceRepo
    url: https://github.com/NagiosEnterprises/ncpa
  - type: SourceRepo
    url: https://github.com/NagiosEnterprises/nrpe
  - type: SourceRepo
    url: https://github.com/NagiosEnterprises/nsca
  - type: SourceRepo
    url: https://github.com/NagiosEnterprises/nrdp
  - type: SourceRepo
    url: https://github.com/NagiosEnterprises/ndoutils
  - type: SourceRepo
    url: https://github.com/NagiosEnterprises/nagios-mod-gearman
  - type: PythonSDK
    url: https://github.com/NagiosEnterprises/napiv2
  - type: SDK
    url: https://github.com/NagiosEnterprises/automation
  - type: PrometheusExporter
    url: https://github.com/NagiosEnterprises/nagprom
  - type: ServiceNowIntegration
    url: https://github.com/NagiosEnterprises/NagiosXI-ServiceNow-EventHandler
  - type: PagerDutyIntegration
    url: https://github.com/NagiosEnterprises/nagiosxi-pagerduty-handler
  - type: VMwareIntegration
    url: https://github.com/NagiosEnterprises/NSXMon
  - type: LinkedIn
    url: https://www.linkedin.com/company/nagios-enterprises-llc
  - type: License
    url: https://github.com/NagiosEnterprises/nagioscore/blob/master/LICENSE
  - type: Plans
    url: plans/nagios-plans-pricing.yml
  - type: Vocabulary
    url: vocabulary/nagios-vocabulary.yml
  - type: JSONLD
    url: json-ld/nagios-context.jsonld
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com