Reports

Report a bad actor or wrong verdict

Submit first-party feedback when Faro got it wrong or when you know an artifact is malicious. The report is stored on the normalized reputation node, invalidates any cached green/yellow verdict for that node, and feeds future checks via tier-2 reputation signals.

post/v1/reports

Request

  • Base URL: https://api.farofinance.app
  • URL: https://api.farofinance.app/v1/reports
  • Auth: HTTP bearer

Request body

type'url' | 'payee' | 'message' | 'document' required
valuestring required

The artifact to report (URL, payee handle, or message text).

kind'scam' | 'phishing' | 'malware' | 'false_positive' | 'other' required

Why the caller is reporting this artifact.

Response

Report accepted.

acceptedboolean

Always true on success.

artifact_idstring required

Normalized reputation node the report attached to.

messagestring required

Human-readable confirmation.

Example response

{
  "artifact_id": "domain:evil-shop.xyz",
  "message": "Report recorded. The next check on this artifact will re-evaluate."
}

Changes

No recorded changes to this operation across all 1 revision of this API.