Basilisk
API referenceReference

Package list for the legacy rail and typed package browser.

GET
/v1/packages

Query Parameters

q?string

Case-insensitive package-name search. Blank/whitespace-only means no search.

view?string

Saved package-browser view. Omitted means all with legacy ordering.

Value in

  • "affected"
  • "all"
  • "unconfirmed"
severity?string

Filter by the highest current latest-version CVSS band.

Value in

  • "critical"
  • "high"
  • "medium"
  • "low"
ecosystem?string

First usable primary/alternative PURL type, or conda-forge fallback.

mapping_state?string

Filter by identity mapping usability.

Value in

  • "mapped"
  • "unmapped"
  • "missing"
latest_result?string

Filter by explicit latest-version result.

Value in

  • "affected"
  • "no_match"
  • "unchecked"
  • "unknown"
  • "not_covered"
sort?string

Package-browser sort. An explicit view defaults to priority.

Value in

  • "priority"
  • "name"
  • "advisory_count"
  • "highest_cvss"
direction?string

Direction for non-priority sorts; null values always sort last.

Value in

  • "asc"
  • "desc"
offset?integer

Zero-based row offset into the filtered/sorted package list.

Formatint64
limit?integer

Window size. Omitted callers get a bounded default, never the full universe.

Formatint64
with_advisories?boolean

Compatibility filter: any confirmed or unconfirmed all-version advisory.

checked?boolean

Compatibility filter: only packages with a usable identity mapping.

Response Body

application/json

curl -X GET "https://example.com/v1/packages"
{  "items": [    {      "browse_ecosystem": "string",      "confirmed_count": 0,      "coverage_status": "string",      "earlier_version_match_count": 0,      "ecosystem": "string",      "highest_cvss": null,      "latest_evaluated_match_count": 0,      "latest_result": "affected",      "latest_version": "string",      "mapping_state": "string",      "name": "string",      "source_coverage": [        {          "evaluated_at": "2019-08-24T14:15:22Z",          "latest_evaluated_match_count": 0,          "source": "string",          "source_last_updated_at": "2019-08-24T14:15:22Z",          "status": "string",          "unavailable_reason": "string"        }      ],      "status": "string",      "unconfirmed_count": 0,      "version_count": 0    }  ],  "limit": 0,  "offset": 0,  "total": 0}

`/v1/advisories/{id}/status` — has basilisk processed this advisory and what did the matcher decide. Unknown ids are a 200 `status: "unknown"`, not a 404: "never seen it" is a first-class answer to this question. GET

Previous Page

Aggregate package-history answer panel for the All versions scope. GET

Next Page