Nagios

Nagios Objects API

Read-only backend for hosts, services, host groups, contacts, downtime, history, and other monitored objects.

GitHub OpenAPI

Operations 12

GET /objects/host List Host Objects #
GET /objects/hoststatus List Host Statuses #
GET /objects/service List Service Objects #
GET /objects/servicestatus List Service Statuses #
GET /objects/hostgroup List Host Groups #
GET /objects/servicegroup List Service Groups #
GET /objects/contact List Contacts #
GET /objects/contactgroup List Contact Groups #
GET /objects/timeperiod List Time Periods #
GET /objects/command List Commands #
GET /objects/downtime List Scheduled Downtime #
GET /objects/statehistory List State History #

Documentation

📖
Documentation
https://support.nagios.com/kb/article/nagios-xi-rest-api-176.html
📖
Documentation
https://www.nagios.org/ncpa/help/3.x/api.html

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/nagios/refs/heads/main/openapi/nagios-objects-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/nagios/refs/heads/main/json-schema/nagios-xi-host-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/nagios/refs/heads/main/json-schema/nagios-xi-service-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/nagios/refs/heads/main/json-structure/nagios-xi-host-structure.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/nagios/refs/heads/main/json-schema/ncpa-metric-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/nagios/refs/heads/main/json-schema/nagios-check-result-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/nagios/refs/heads/main/json-structure/nagios-check-result-structure.json

Other Resources

🔗
API PDF Guide
https://assets.nagios.com/downloads/nagiosxi/docs/Accessing-and-Using-the-XI-REST-API.pdf
🔗
Backend API
https://assets.nagios.com/downloads/nagiosxi/docs/Accessing_The_XI_Backend_API.pdf
🔗
Automated Host Management
https://assets.nagios.com/downloads/nagiosxi/docs/Automated_Host_Management.pdf
🔗
SpectralRules
https://raw.githubusercontent.com/api-evangelist/nagios/refs/heads/main/rules/nagios-xi-rules.yml
🔗
GitHub
https://github.com/NagiosEnterprises/ncpa
🔗
SpectralRules
https://raw.githubusercontent.com/api-evangelist/nagios/refs/heads/main/rules/ncpa-rules.yml
🔗
GitHub
https://github.com/NagiosEnterprises/nrdp

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/nagios-objects-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

nagios-objects-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Nagios XI REST Objects API
  description: 'Built-in REST API for Nagios XI, the commercial enterprise distribution of

    Nagios. The API is split into three sections: Objects (read-only backend for

    hosts, services, contacts, host groups, etc.), 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

    when `pretty=1` or by default. Authentication uses a per-user Nagios XI API

    key passed via the `apikey` query parameter.

    '
  version: v1
  contact:
    name: Nagios Enterprises
    url: https://www.nagios.com/products/nagios-xi/
  license:
    name: Nagios XI Commercial License
    url: https://www.nagios.com/legal/agreements/
servers:
- url: https://{nagiosXiHost}/nagiosxi/api/v1
  description: Self-hosted Nagios XI instance
  variables:
    nagiosXiHost:
      default: nagios.example.com
      description: Hostname or IP address of the Nagios XI server
security:
- ApiKeyQuery: []
- ApiKeyHeader: []
tags:
- name: Objects
  description: Read-only backend for hosts, services, host groups, contacts, downtime, history, and other monitored objects.
paths:
  /objects/host:
    get:
      tags:
      - Objects
      summary: List Host Objects
      operationId: listHostObjects
      parameters:
      - $ref: '#/components/parameters/Pretty'
      - name: host_name
        in: query
        schema:
          type: string
        description: Filter by host name (supports `name-lk=` modifier for substring match).
      - name: records
        in: query
        schema:
          type: string
          example: '20:10'
        description: Pagination, format `count` or `count:startingAt`.
      - name: orderby
        in: query
        schema:
          type: string
          example: host_name:a
        description: Order by column, `:a` ascending or `:d` descending.
      responses:
        '200':
          description: Host objects.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HostList'
  /objects/hoststatus:
    get:
      tags:
      - Objects
      summary: List Host Statuses
      operationId: listHostStatuses
      parameters:
      - $ref: '#/components/parameters/Pretty'
      - name: host_name
        in: query
        schema:
          type: string
      responses:
        '200':
          description: Host status records.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HostStatusList'
  /objects/service:
    get:
      tags:
      - Objects
      summary: List Service Objects
      operationId: listServiceObjects
      parameters:
      - $ref: '#/components/parameters/Pretty'
      - name: host_name
        in: query
        schema:
          type: string
      - name: service_description
        in: query
        schema:
          type: string
      responses:
        '200':
          description: Service objects.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceList'
  /objects/servicestatus:
    get:
      tags:
      - Objects
      summary: List Service Statuses
      operationId: listServiceStatuses
      parameters:
      - $ref: '#/components/parameters/Pretty'
      - name: host_name
        in: query
        schema:
          type: string
      - name: name
        in: query
        schema:
          type: string
        description: Service description (with optional `-lk` modifier).
      responses:
        '200':
          description: Service status records.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceStatusList'
  /objects/hostgroup:
    get:
      tags:
      - Objects
      summary: List Host Groups
      operationId: listHostGroups
      parameters:
      - $ref: '#/components/parameters/Pretty'
      responses:
        '200':
          description: Host group objects.
  /objects/servicegroup:
    get:
      tags:
      - Objects
      summary: List Service Groups
      operationId: listServiceGroups
      parameters:
      - $ref: '#/components/parameters/Pretty'
      responses:
        '200':
          description: Service group objects.
  /objects/contact:
    get:
      tags:
      - Objects
      summary: List Contacts
      operationId: listContacts
      parameters:
      - $ref: '#/components/parameters/Pretty'
      responses:
        '200':
          description: Contact objects.
  /objects/contactgroup:
    get:
      tags:
      - Objects
      summary: List Contact Groups
      operationId: listContactGroups
      parameters:
      - $ref: '#/components/parameters/Pretty'
      responses:
        '200':
          description: Contact group objects.
  /objects/timeperiod:
    get:
      tags:
      - Objects
      summary: List Time Periods
      operationId: listTimePeriods
      parameters:
      - $ref: '#/components/parameters/Pretty'
      responses:
        '200':
          description: Time period objects.
  /objects/command:
    get:
      tags:
      - Objects
      summary: List Commands
      operationId: listCommands
      parameters:
      - $ref: '#/components/parameters/Pretty'
      responses:
        '200':
          description: Command objects.
  /objects/downtime:
    get:
      tags:
      - Objects
      summary: List Scheduled Downtime
      operationId: listDowntime
      parameters:
      - $ref: '#/components/parameters/Pretty'
      responses:
        '200':
          description: Scheduled downtime records.
  /objects/statehistory:
    get:
      tags:
      - Objects
      summary: List State History
      operationId: listStateHistory
      parameters:
      - $ref: '#/components/parameters/Pretty'
      - name: starttime
        in: query
        schema:
          type: integer
          format: int64
        description: Unix timestamp (default 24 hours ago).
      - name: endtime
        in: query
        schema:
          type: integer
          format: int64
        description: Unix timestamp (default now).
      responses:
        '200':
          description: State history records.
components:
  schemas:
    Host:
      type: object
      properties:
        host_object_id:
          type: string
        host_name:
          type: string
        display_name:
          type: string
        address:
          type: string
        check_command:
          type: string
        max_check_attempts:
          type: integer
        check_interval:
          type: number
        retry_interval:
          type: number
        notification_interval:
          type: number
        notification_period:
          type: string
        contacts:
          type: string
        contact_groups:
          type: string
        hostgroups:
          type: array
          items:
            type: string
    HostList:
      type: object
      properties:
        recordcount:
          type: integer
        host:
          type: array
          items:
            $ref: '#/components/schemas/Host'
    HostStatus:
      type: object
      properties:
        host_object_id:
          type: string
        host_name:
          type: string
        current_state:
          type: integer
          enum:
          - 0
          - 1
          - 2
          - 3
          description: 0=UP, 1=DOWN, 2=UNREACHABLE, 3=UNKNOWN.
        status_update_time:
          type: string
          format: date-time
        last_check:
          type: string
          format: date-time
        last_state_change:
          type: string
          format: date-time
        output:
          type: string
        perfdata:
          type: string
        notifications_enabled:
          type: integer
          enum:
          - 0
          - 1
        active_checks_enabled:
          type: integer
          enum:
          - 0
          - 1
        passive_checks_enabled:
          type: integer
          enum:
          - 0
          - 1
    ServiceStatus:
      type: object
      properties:
        service_object_id:
          type: string
        host_name:
          type: string
        service_description:
          type: string
        current_state:
          type: integer
          enum:
          - 0
          - 1
          - 2
          - 3
          description: 0=OK, 1=WARNING, 2=CRITICAL, 3=UNKNOWN.
        last_check:
          type: string
          format: date-time
        last_state_change:
          type: string
          format: date-time
        output:
          type: string
        perfdata:
          type: string
    ServiceList:
      type: object
      properties:
        recordcount:
          type: integer
        service:
          type: array
          items:
            $ref: '#/components/schemas/Service'
    HostStatusList:
      type: object
      properties:
        recordcount:
          type: integer
        hoststatus:
          type: array
          items:
            $ref: '#/components/schemas/HostStatus'
    ServiceStatusList:
      type: object
      properties:
        recordcount:
          type: integer
        servicestatus:
          type: array
          items:
            $ref: '#/components/schemas/ServiceStatus'
    Service:
      type: object
      properties:
        service_object_id:
          type: string
        host_name:
          type: string
        service_description:
          type: string
        display_name:
          type: string
        check_command:
          type: string
        max_check_attempts:
          type: integer
        check_interval:
          type: number
        retry_interval:
          type: number
        notification_interval:
          type: number
        check_period:
          type: string
        notification_period:
          type: string
  parameters:
    Pretty:
      name: pretty
      in: query
      schema:
        type: integer
        enum:
        - 0
        - 1
        default: 0
      description: Set to 1 to return human-readable formatted JSON.
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: apikey
    ApiKeyHeader:
      type: apiKey
      in: header
      name: X-API-KEY