Skip to main content
POST
Ingest Risk Signal

Headers

Response

string
UUID of the created risk signal.
integer
The ingested risk score (0–100).
string
ISO 8601 timestamp of ingestion.

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Body

application/json
signal_source
string
required
signal_type
string
required

Classification of the risk signal

Example:

"velocity_anomaly"

subject_id
string
required
subject_type
string
required
idempotency_key
string
ip_address
string
payload
any
risk_score
integer
user_agent
string

Response

Risk signal ingested

id
string<uuid>
tenant_id
string<uuid>
source
string

Origin of the signal (e.g. device_fingerprint, ip_reputation, email_verification, document_analysis, behavioral)

Example:

"device_fingerprint"

signal_type
string

Classification of the risk signal

Example:

"velocity_anomaly"

score
number<float>

Risk score between 0 (no risk) and 1 (highest risk)

Required range: 0 <= x <= 1
Example:

0.85

details
object

Arbitrary metadata associated with the signal

Example:
entity_type
enum<string>

The type of entity this signal relates to

Available options:
user,
device,
ip,
document,
session
Example:

"user"

entity_id
string

Identifier of the entity being evaluated

Example:

"usr_8f14e45f"

created_at
string<date-time>