provider Security Monitoring GET /api/v2/security/findings
@utdk/datadog /api/v2/security/findings
List security findings
Get a list of security findings that match a search query. [See the schema for security findings](https://docs.datadoghq.com/security/guide/findings-schema/). ### Query Syntax This endpoint uses the logs query syntax. Findings attributes (living in the attributes.attributes. namespace) are prefixed by @ when queried. Tags are queried without a prefix. Example: `@severity:(critical OR high) @status:open team:platform`
filter[query] query
The search query following log search syntax.
string
page[cursor] query
Get the next page of results with a cursor provided in the previous query.
string
page[limit] query
The maximum number of findings in the response.
integer
sort query
Sorts by @detection_changed_at.
enum: @detection_changed_at, -@detection_changed_at

Try it

Authentication
Configure credentials for Datadog API V2 Collection
Gateway
The gateway proxies requests and injects credentials server-side. Configure credentials above, then enter your gateway URL.

Saved automatically to browser storage.

listsecurityfindings
GET/api/v2/security/findings
Get a list of security findings that match a search query. [See the schema for security findings](https://docs.datadoghq.com/security/guide/findings-schema/). ### Query Syntax This endpoint uses the logs query syntax. Findings attributes (living in the attributes.attributes. namespace) are prefixed by @ when queried. Tags are queried without a prefix. Example: `@severity:(critical OR high) @status:open team:platform`

The search query following log search syntax.

Get the next page of results with a cursor provided in the previous query.

The maximum number of findings in the response.

Sorts by @detection_changed_at.

Enter a gateway URL above to enable sending.

Code snippet
Updates live as you fill in the form above.

TypeScript

import datadog from '@utdk/datadog';

await datadog.listsecurityfindings({
  "filter[query]": "*",
  "page[limit]": 10,
  "sort": "-@detection_changed_at"
})