List alerts

1 min

GET

https://api.detected.app/api/v2/public/alerts

Returns the alerts raised for profiles in your account, most recent first. An alert is raised when monitored information about a profile changes. Use the query parameters to filter the results.

This endpoint is paginated. Use the page parameter to request further pages. The meta and links objects in the response describe the current page and link to the others.

pagestringPage number of the results to return, starting from 1. The number of items per page is returned in <code>meta.per_page</code>.

acknowledgedstringFilter by acknowledgement status: <code>cleared</code> for alerts that a user has cleared. The other listed value, <code>uncleared</code>, is currently rejected as an invalid filter. These values differ from the values returned in the alert's <code>acknowledged</code> property.

profile_idstring<uuid>Filter by profile UUID.

acceptstringGenerated from available response content types

200OK

401Unauthorized. The access token is missing, invalid or has expired.

422Unprocessable Content. The request was understood but failed validation. The response lists the fields that failed and why.

429Too Many Requests. You have exceeded the rate limit. Wait for the number of seconds given in the <code>Retry-After</code> header before trying again.

curl --request GET \
     --url https://api.detected.app/api/v2/public/alerts \
     --header 'accept: application/json'

Have a question?

Our knowledgeable support team and an awesome community will get you an answer in a flash.

To ask a question or participate in discussions, you'll need to authenticate first.