Software

Get one software product (Market)

One engine of the software library: the same row the list returns (product metadata, host count per observed role, first/last seen, the compliance signal and the host-count trend) plus the catalogue version and generation stamp. engine is a catalogue engine slug as published in engine on the list; an unknown slug is a 404.

Beyond the list row it also returns advisory_list[] (issue #798): every live advisory of the engine's lanes with its id, normalized severity, CVSS score, summary, url and publication stamp, newest first. Null when no lane of the engine has an advisory feed; [] when it has one and upstream has published nothing. Market tier.

get/v1/software/{engine}

Request

  • Base URL: https://api.peppolstatus.com
  • URL: https://api.peppolstatus.com/v1/software/{engine}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

enginestring required

The catalogue engine slug, e.g. phoss.

Query parameters

daysinteger

Trend window in trailing UTC days, 1..90 (default 90).

Response

The engine's library entry.

enginestring required

The catalogue engine slug.

display_namestring required
vendorstring nullable required
category'smp' | 'ap' | 'both' | 'unknown' required
homepagestring nullable required
hostsinteger required

Current production host+role targets running the engine.

first_seenstring date-time nullable required

First observation of the engine anywhere on the network.

last_seenstring date-time nullable required

End of the most recent observation window — the request instant while the engine is still present.

catalogue_versioninteger required
trend_fromstring date required
trend_tostring date required
generated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.