Report a malicious domain
POST/domains/report
Submit a known-malicious domain to Chainara's threat database and dispatch it
to the Intel Domain Monitor for immediate worker investigation. The domain is upserted
into malicious_domains with a baseline risk score of 55 (deliberately below the
platform's auto-publish gate of 65, the scanner owns the final score, not the submission)
and published directly to the chainara-domain-alerts Pub/Sub topic, bypassing the
score gate.
Idempotent, resubmitting the same domain never downgrades an existing risk score;
it increments a total_requests counter in metadata and returns is_resubmission: true.
If Pub/Sub is temporarily unavailable the domain is still recorded in the database.
The response will show status: recorded_pending_queue instead of scan_queued,
retry to attempt immediate queuing.
blockchain_id is optional. Omit it if the blockchain context is unknown, the domain
is stored under a neutral ID and the response will show blockchain_context_known: false.
It is never misrepresented as XRPL or any other chain.
Request
Responses
- 202
- 400
- 403
Domain recorded and scan queued
Invalid domain or request body
Enterprise API key required