---
title: "Get a host's uptime aggregates"
method: GET
path: "/v1/hosts/{hostname}/uptime"
tags: ["Hosts"]
---

# Get a host's uptime aggregates

`GET /v1/hosts/{hostname}/uptime`

## Request

- Base URL: `https://api.peppolstatus.com`
- URL: `https://api.peppolstatus.com/v1/hosts/{hostname}/uptime`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

The aggregate ladder for a host at a chosen resolution, per-location plus the `__all__` rollup, optionally windowed by `[from, to)`, cursor-paginated.

## Path parameters

- `hostname` string, required

## Query parameters

- `resolution` 'hourly' | 'daily' | 'monthly'
- `from` string, date-time
- `to` string, date-time
- `location` string
- `limit` integer
- `cursor` string

## Response `200`

A page of uptime buckets.

- UptimePage: A page of uptime aggregate buckets.
  - `items` UptimeBucket[], required
    - `resolution` 'hourly' | 'daily' | 'monthly', required
    - `hostname` string, required
    - `role` 'SMP' | 'AP', required
    - `location` string, required
    - `bucket_start` string, date-time, required
    - `checks_total` integer, required
    - `up` integer, required
    - `degraded` integer, required
    - `down` integer, required
    - `uptime_pct` number, required
    - `phases` UptimePhasePercentiles, required
      - `dns` UptimePercentiles, required: Latency percentiles for one phase, whole milliseconds.
        - `p50` number, required
        - `p95` number, required
        - `p99` number, required
      - `tcp` UptimePercentiles, required: Latency percentiles for one phase, whole milliseconds.
        - `p50` number, required
        - `p95` number, required
        - `p99` number, required
      - `tls` UptimePercentiles, required: Latency percentiles for one phase, whole milliseconds.
        - `p50` number, required
        - `p95` number, required
        - `p99` number, required
      - `http` UptimePercentiles, required: Latency percentiles for one phase, whole milliseconds.
        - `p50` number, required
        - `p95` number, required
        - `p99` number, required
      - `total` UptimePercentiles, required: Latency percentiles for one phase, whole milliseconds.
        - `p50` number, required
        - `p95` number, required
        - `p99` number, required
  - `next_cursor` string, nullable, required: Opaque cursor for the next page, or null on the last page.

## Other responses

- `400`: An invalid `resolution`, range, `limit` or `cursor`.

---

[API](https://skmtc.dev/peppolstatus/apis/peppolstatus-api.md) · [All operations](https://skmtc.dev/peppolstatus/apis/peppolstatus-api/llms.txt) · [OpenAPI document](https://skmtc.dev/peppolstatus/apis/peppolstatus-api/revisions/7e74fb32f23c?raw)