---
title: "Software landscape history"
method: GET
path: "/v1/stats/software/history"
tags: ["Software"]
---

# Software landscape history

`GET /v1/stats/software/history`

## Request

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

The software landscape over time, derived from the temporal software table in one windowed pass: per UTC day, the host-weighted identified/total targets and the k-anonymised vendor shares. Keyless-cacheable.

## Query parameters

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

## Response `200`

The software landscape time series.

- object
  - `from` string, date, required
  - `to` string, date, required
  - `series` object[], required
    - `day` string, date, required
    - `total_targets` integer, required
    - `identified_targets` integer, required
    - `vendors` object[], required
      - `engine` string, required
      - `hosts` integer, required
      - `probed` integer, required
      - `reported` integer, required
      - `share` number, required

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