Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Nagios Objects API

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

Nagios Objects API is one of 13 APIs that Nagios publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 6 JSON Schema definitions.

Tagged areas include Objects. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

This API exposes 12 operations across 12 paths, and defines 8 schemas. It is described by OpenAPI 3.0.3, at version v1.

Requests are made against a single base URL, https://{nagiosXiHost}/nagiosxi/api/v1.

12 operations 12 paths 8 schemas 12 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
v1
Base URL
https://{nagios-xi-host}/nagiosxi/api/v1
Authentication
API Key, API Key
Resource Areas
1

Authentication & Security 2

Nagios Objects API declares 2 security schemes for authenticating requests. An API key is passed in the query as apikey (ApiKeyQuery). An API key is passed in the header as X-API-KEY (ApiKeyHeader). By default, every request must be authenticated.

Paths & Operations 12

Across 12 paths, the API surfaces 12 operations — 12 GET. Each is listed below with its method, path, parameters, and response codes.

Objects 12

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

GET
/objects/host
List Host Objects
listHostObjects 4 params → 200
GET
/objects/hoststatus
List Host Statuses
listHostStatuses 2 params → 200
GET
/objects/service
List Service Objects
listServiceObjects 3 params → 200
GET
/objects/servicestatus
List Service Statuses
listServiceStatuses 3 params → 200
GET
/objects/hostgroup
List Host Groups
listHostGroups 1 param → 200
GET
/objects/servicegroup
List Service Groups
listServiceGroups 1 param → 200
GET
/objects/contact
List Contacts
listContacts 1 param → 200
GET
/objects/contactgroup
List Contact Groups
listContactGroups 1 param → 200
GET
/objects/timeperiod
List Time Periods
listTimePeriods 1 param → 200
GET
/objects/command
List Commands
listCommands 1 param → 200
GET
/objects/downtime
List Scheduled Downtime
listDowntime 1 param → 200
GET
/objects/statehistory
List State History
listStateHistory 3 params → 200

Schemas 8

The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are Host (13 properties), Service (11 properties), HostStatus (11 properties), ServiceStatus (8 properties). Each schema is shown below with its type and property counts.

ServiceStatusList
object
2 properties
ServiceList
object
2 properties
HostStatusList
object
2 properties
HostList
object
2 properties
Host
object
13 properties
ServiceStatus
object
8 properties
Service
object
11 properties
HostStatus
object
11 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

nagios-objects-api-openapi.yml Raw ↑

Other APIs Nagios publishes across the network.

NSCA (Nagios Service Check Acceptor)
NRPE (Nagios Remote Plugin Executor)
Nagios Config API
Nagios CPU API
Nagios Disk API
Nagios Interface API
Nagios Memory API
Nagios Plugins API
Nagios Processes API
Nagios Services API
Nagios Submission API
Nagios System API