Skip to main content
POST
Search attack-pattern 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 attack-pattern conditions include id, alias, record_state, updated_at, and weakness. 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