---
title: "Graph - Listing"
description: ""
url: "https://docs.itrsgroup.com/docs/opsview/6.11.7/rest-api/graph/api-graph-listing/index.html"
---
## Parameters

- `end` — expected as number of epoch seconds. Defaults to now.
- `start` — epoch seconds. Defaults to end subtract 1 day duration. This has priority over duration.
- `duration` — specify duration. Use `h`, `d`, `w` for hours, days, weeks respectively. `m` is assumed to be minutes - use `months` and `minutes` for clarity. (Note: This parameter used to be based on RRDtool format, but is now a custom format to Opsview). Default: 1d. Examples:
    - `3145h` — 3145 hours
    - `131d1h` — 131 days and 1 hour
    - `18w5d1h` — 18 weeks, 5 days and 1 hour
- `hsm` — in the format of hostname::servicename::metricname. Can be repeated. If the performance metric is not found, it is ignored from the response.
- `keyword` — search for all hsms related to the specified keyword. Can be repeated. Be aware this could return a large amount of data if there are matches to lots of hsms
- `hostname` — search for all hsms related with this host name. Can have wildcards. Can be repeated.
- `servicename` — search for all hsms related with this service name. Can have wildcards. Can be repeated.
- `metricname` — search for all hsms with this metric name. Can have wildcards. Can be repeated.
- `include_offset_timezone` — Defaults to 0. Set this to 1 to adjust the time value so that the current timezone offset from UTC (based on the Opsview server) is included in the time value. This is not required in most cases.

## Example response

```
    {
      list => [
        {
          data => [
            [1242849600, 517],  // Time in Unix epoch seconds and value at this time
            [1242936000, 517],  // Note: The value could be null/empty string to mean "no value at this time" - this should be represented as a gap in any graphs
            ....
            [1254168000, 505],
          ],
          description => "Min: 505.000<br />Max: 517.000<br />Average: 511.305",
          label => "opsview::Opsview HTTP::size",
          uom => "bytes",
        }
      ],
    }
```

The time parameter is the number of seconds since epoch. This time is returned back in UTC format. See the include_offset_timezone parameter if you want this value adjusted based on the timezone. Note, it is not possible to return this value as a date time formatted string.

