Skip to main content
POST
Search weakness records with text, identifiers, recursive conditions, sorting, and cursor pagination. The resource path fixes the entity type, so do not add an entity condition. Common weakness conditions include id, alias, record_state, published_at, and updated_at. See Query builder for their operators.

Authorizations

Authorization
string
header
required

Send the API key as Authorization: Bearer .

Headers

X-API-Version
enum<string>
default:2026-08-19

API contract version. Omit to use the latest public version. Current supported value: 2026-08-19.

Available options:
2026-08-19

Query Parameters

cursor
string

Opaque cursor carried by _meta.next.url. Reuse the previous request body unchanged.

Required string length: 1 - 4096

Body

application/json
sort
enum<string>

An ordered array composes multiple sort fields. A single string remains supported for compatibility. relevance cannot be composed, and software_kind requires an effective software entity scope.

Available options:
relevance,
id,
updated,
first_seen,
published,
cvss,
epss,
record_state,
exploitation,
aliases,
weaknesses,
ecosystems,
ecosystem,
software_kind,
purl
Example:
order
enum<string>

Legacy direction used only when sort is a single string. Ordered sort clauses include their own direction.

Available options:
asc,
desc
q
string

Full-text query. Recognized security identifiers are treated as exact identifier lookups.

Example:

"log4j"

id
string

A CVE is one possible public identifier for a vulnerability. It is not a severity or exploitation status.

Example:

"CVE-2021-44228"

entity
enum<string>[]

Restrict mixed /search results to one or more entity types.

Available options:
vulnerability,
advisory,
weakness,
software,
attack-pattern
where
object
include
enum<string>[]

Optional projections to include.

Available options:
attributes,
provenance,
conflicts,
relationships
limit
integer
default:20
Required range: 1 <= x <= 100
software_kind
enum<string>[]
Available options:
package,
application,
operating_system,
appliance,
hardware,
firmware
software_kind_not
enum<string>[]
Available options:
package,
application,
operating_system,
appliance,
hardware,
firmware
affected_software
string[]
Example:
affected_software_not
string[]
Example:
affected_software_contains
string
Example:

"npm/react"

affected_software_not_contains
string
Example:

"npm/react"

purl
string[]
Example:
purl_not
string[]
Example:
purl_contains
string
Example:

"npm/react"

purl_not_contains
string
Example:

"npm/react"

cpe
string[]
Example:
cpe_not
string[]
Example:
cpe_contains
string
Example:

"linux_kernel"

cpe_not_contains
string
Example:

"linux_kernel"

Response

A cursor-paginated collection of normalized records.

data
object[]
required
_meta
object
required