Tutorial · Company API · Pro

    Report phishing automatically from your SOC

    Turn confirmed phishing from your SOC, SIEM or abuse mailbox into Fraudpol cases automatically. Every case is accepted instantly and handled by our takedown team.

    1Create a key with the submit scope

    In Company dashboard → Developers, create a key with Full access. Report submission needs Pro or Enterprise.

    2Submit the case

    Send the URL (or domain), a category and a description of at least 30 characters. Add up to three screenshots as base64 PNG or JPEG (1.5 MB each) and evidence links. Use your own ticket ID as external_ref: sending the same value again returns the existing case instead of a duplicate, so retries are safe.

    curl -X POST "https://ugapgzpffrykyglevlhz.supabase.co/functions/v1/blackwall-api/v1/reports" \
      -H "X-API-Key: $FP_COMPANY_KEY" -H "Content-Type: application/json" \
      -d '{
        "url": "https://login.fake-bank.example/verify",
        "category": "phishing-page",
        "description": "Credential phishing page copying our login, reported by 14 customers today.",
        "external_ref": "SOC-48213",
        "evidence_urls": ["https://urlscan.io/result/…"]
      }'

    3Follow the case

    Store id and read GET /v1/reports/<id> for the status, history, takedowns and evidence, or let a webhook tell you. Cases move Accepted → In progress → Resolved – taken down or Resolved – no threat.