---
title: "Runtime - Host and Services"
description: ""
url: "https://docs.itrsgroup.com/docs/opsview/6.11.7/rest-api/runtime/api-runtime-host-and-services/index.html"
---
This section is for searching for live objects being monitored by Opsview. This is in the Runtime database, hence the URL path is `/rest/runtime/{objecttype}`.

URL: `/rest/runtime/service`

Requires authentication - requires VIEWALL or VIEWSOME permission

-  `GET` — returns available objects, either grouped by host or grouped by service.
-  `POST`, `PUT`, `DELETE` — not implemented.

## Access Control

VIEWALL allows all objects to be returned.
VIEWSOME allows objects to be returned where permission has been granted based on the access object selection.

## Retrieving Host or Service Lists

The same parameters as searching based on [service filtering](https://docs.itrsgroup.com/docs/opsview/6.11.7/rest-api/status/api-status-request-format/index.html) can be used.

Additional parameters:

- `rows` — returns back this number of rows. Defaults to 50 rows.
- `group_by` — returns results based on either host or service. Defaults to host.
- `distinct` — if set to 1, then only a distinct list of hosts or services are returned. This means you are searching for host names or service names rather than a host+service combination.

Response:

- `rows` — the number of actual rows returned.
- `allrows` — the total number of rows based on filtering parameters.
- `total` — the total number of rows if filtering is not applied.
- `list` — an array of the results.

Example response, if `group_by=host` and `distinct=0`:

```
    {
       "allrows" : "30",
       "list" : [
          {
             "list" : [
                "Another exception",
                "Coldstart",
                "Test exceptions"
             ],
             "name" : "cisco"
          },
          {
             "list" : [
                "Another exception",
                "Coldstart"
             ],
             "name" : "cisco1"
          }
       ],
       "rows" : "5",
       "total" : "50"
    }
```

Example response if `group_by=service` and `distinct=0`:

```
    {
       "allrows" : "30",
       "list" : [
          {
             "list" : [
                "cisco",
                "cisco1",
                "cisco2",
                "cisco3",
                "cisco4"
             ],
             "name" : "Another exception"
          }
       ],
       "rows" : "5",
       "total" : "50"
    }
```

Example response if group_by=host and distinct=1:

```
    {
       "allrows" : "12",
       "list" : [
          {
             "name" : "cisco"
          },
          {
             "name" : "cisco1"
          },
          {
             "name" : "cisco2"
          },
          {
             "name" : "cisco3"
          },
          {
             "name" : "cisco4"
          }
       ],
       "rows" : "5",
       "total" : "15"
    }
```

Example response if `group_by=service` and `distinct=1`:

```
    {
       "allrows" : "12",
       "list" : [
          {
             "name" : "Another exception"
          },
          {
             "name" : "Check Loadavg"
          },
          {
             "name" : "Check Memory"
          },
          {
             "name" : "Coldstart"
          },
          {
             "name" : "faked ok service"
          }
       ],
       "rows" : "5",
       "total" : "19"
    }
```


