---
title: "Get the network verdict history"
method: GET
path: "/v1/network/history"
tags: ["Network"]
---

# Get the network verdict history

`GET /v1/network/history`

## Request

- Base URL: `https://api.peppolstatus.com`
- URL: `https://api.peppolstatus.com/v1/network/history`
- Auth: none required

The host verdict mix over time, derived from the temporal verdict table in one windowed pass: per UTC day, the rows open at 00:00 that day, counted by verdict. Two caveats. Counts are (hostname, role) pairs — a host serving two roles counts twice, the same grain as `/v1/network`. And before 2026-08-15 an unresolvable host was recorded as `down`, so `unresolvable` reads 0 over the earlier stretch. The series starts 2026-07-21, the first day the table covers; an earlier `from` is clamped to it. Keyless-cacheable.

## Query parameters

- `from` string, date
- `to` string, date

## Response `200`

The network verdict time series.

- object
  - `from` string, date, required
  - `to` string, date, required
  - `series` object[], required
    - `day` string, date, required
    - `hosts` integer, required: (hostname, role) pairs with a verdict open at 00:00 UTC.
    - `up` integer, required
    - `degraded` integer, required
    - `down` integer, required
    - `unresolvable` integer, required: 0 before 2026-08-15, when these were counted as `down`.

## Other responses

- `400`: An invalid `from` or `to`, or a window over 366 days.

---

[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)
