Basilisk
API referenceReference

`/v1/advisories` — one row per canonical advisory. Canonical grouping is performed before search/facets, saved views, totals, sorting, and windowing.

GET
/v1/advisories

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.

Formatint64
Range0 <= value
Default0
limit?integer

Window size, clamped to 0–200. Omitted callers get 100 rows.

Formatint64
Range0 <= value <= 200
Default100

Response 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  }}

Generated endpoint reference

Static pages generated from the Basilisk OpenAPI document.

`/v1/advisories/summary` — canonical advisory counts by headline severity band. This is the purpose-built aggregate behind browse summary tiles: it reuses the browse list's canonical universe (rollups joined back to their source records) and its headline-score bounds, but skips the per-group display metadata, search, sorting, and windowing that make the full browse query expensive, so callers no longer issue several `limit=1` browse requests just to read totals. GET

Next Page