API Reference

List Alerts

get
https://api.doppel.com/v2/alerts

List alerts for the authenticated organization.
The organization is determined from the org_id claim in the JWT.
Searches address at most 50,000 results; narrow the activity time range
when a broader search returns result_window_exceeded.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
queue_state
array of strings

Comma-separated queue states to filter alerts by. A single value is
also accepted.
(Note: taken_down is equivalent to Resolved in the Doppel Vision App)

queue_state
Allowed:
string
enum

Filter by product category.

string
enum

The field to sort alerts by. Must be provided together with sort_order. Defaults to date_sourced descending if neither is specified.

  • date_sourced: Sort by alert creation date.
  • last_activity: Sort by the date of the most recent alert activity.
  • last_actioned_at: Sort by the date of the most recent enforcement action.
  • date_last_actioned: Legacy alias for last_activity. Do not use it for a new integration.
Allowed:
string
enum

Sort direction. Must be provided together with sort_type. Defaults to desc if neither is specified.

Allowed:
string

Search alerts by entity (URL/phone/email) substring match.

date-time

ISO 8601 timestamp. Return alerts created at or after this time.

date-time

ISO 8601 timestamp. Return alerts created at or before this time.

date-time

ISO 8601 timestamp. Return alerts with activity at or after this time.

date-time

ISO 8601 timestamp. Return alerts with activity at or before this time.

integer
0 to 200
Defaults to 100

Maximum number of recent audit log entries to return for each alert.

string
enum
Defaults to full

Response detail level. full returns the standard alert response.
basic returns only id, entity, queue_state, entity_state,
severity, product, created_at, and last_activity_timestamp.

Allowed:
tags
array of strings

Comma-separated list of tag names to filter alerts by.

tags
brand_ids
array of uuids

Comma-separated brand UUIDs. Matches the alert's original brand.

brand_ids
severity
array of strings

Comma-separated severity values (high, medium, low).

severity
Allowed:
entity_state
array of strings

Comma-separated entity states (active, down, parked, and other EntityState values).

entity_state
platform
array of strings

Comma-separated Platform enum values.

platform
integer
Defaults to 0

Page number (0-indexed). Defaults to 0 server-side.

integer
1 to 200
Defaults to 30

Number of items per page. Defaults to 30, max 200.

Responses

Updated 3 months ago

Did this page help you?
Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago

Did this page help you?