API referenceReference
`/v1/advisories` — one row per canonical advisory. Canonical grouping is performed before search/facets, saved views, totals, sorting, and windowing.
Query Parameters
q?string
Case-insensitive canonical id, source id, package, or summary search.
view?
Saved view applied after canonical grouping.
Default
"all"source?string
Keep canonical groups containing this source.
Value in
- "osv"
- "nvd"
severity?string
Filter by the canonical group's highest CVSS score.
Value in
- "critical"
- "high"
- "medium"
- "low"
- "unscored"
sort?
Canonical row ordering; every order uses canonical_id as its final tie-breaker.
Default
"severity_desc"offset?integer
Zero-based row offset. Negative values are normalized to zero.
Format
int64Range
0 <= valueDefault
0limit?integer
Window size, clamped to 0–200. Omitted callers get 100 rows.
Format
int64Range
0 <= value <= 200Default
100Response Body
application/json
curl -X GET "https://example.com/v1/advisories"{ "items": [ { "advisory_kind": "string", "affects_latest": true, "applicability": "string", "canonical_id": "string", "ecosystem": "string", "matched_package_count": 0, "package_name": "string", "severities": [ { "band": "string", "score": 0, "score_type": "string", "source_advisory_id": "string", "source_kind": "string", "vector": "string" } ], "severity": null, "source_advisory_ids": [ "string" ], "source_kinds": [ "string" ], "summary": "string", "unconfirmed_package_count": 0, "updated_at": "2019-08-24T14:15:22Z" } ], "limit": 0, "offset": 0, "total": 0, "view_totals": { "affects_latest": 0, "all": 0, "malware": 0, "unconfirmed": 0 }}Empty