PII Detection for Law Firms & eDiscovery

curl -X POST https://piidetectionapi.com/api/moderate.php \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY",
    "api_type": "pii_detection",
    "text": "Exhibit C: Judgment debtor Anna Whitfield, born 06/02/1979, SSN 431-88-2205, account 004482913344 at First Meridian Bank.",
    "entities": ["PERSON_NAME", "DATE_OF_BIRTH", "SSN", "FINANCIAL_ACCOUNT_NUMBER"],
    "mask_mode": "replace",
    "threshold": 0.4
  }'

import requests, json, pathlib

API_URL = "https://piidetectionapi.com/api/moderate.php"

PROTECTIVE_ORDER_ENTITIES = [
    "PERSON_NAME", "SSN", "TAX_ID", "DATE_OF_BIRTH",
    "FINANCIAL_ACCOUNT_NUMBER", "CREDIT_CARD_NUMBER",
    "ADDRESS", "PHONE_NUMBER", "EMAIL_ADDRESS",
    "DRIVERS_LICENSE_NUMBER", "PASSPORT_NUMBER", "MEDICAL_DATA",
]

def scan_document(doc_id: str, text: str) -> dict:
    resp = requests.post(
        API_URL,
        json={
            "api_key": "YOUR_API_KEY",
            "api_type": "pii_detection",
            "text": text[:50000],  # chunk longer documents
            "entities": PROTECTIVE_ORDER_ENTITIES,
            "mask_mode": "replace",
            "threshold": 0.4,  # recall-first: over-flag, let reviewers clear
            "custom_instruction": "Do not flag names of attorneys of record or the presiding judge.",
        },
        timeout=30,
    )
    return {"doc_id": doc_id, **resp.json()}

# Emit a redaction worksheet: one row per hit, with offsets for the review tool
for path in pathlib.Path("production_vol_003").glob("*.txt"):
    report = scan_document(path.stem, path.read_text())
    for e in report["detected_entities"]:
        print(json.dumps({
            "doc": report["doc_id"], "type": e["type"],
            "start": e["start"], "end": e["end"], "conf": e["confidence"],
        }))

// Classify identifiers in a web intake submission before it is stored or emailed
async function gateIntakeSubmission(formText) {
  const resp = await fetch("https://piidetectionapi.com/api/moderate.php", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      api_key: process.env.PII_API_KEY,
      api_type: "pii_detection",
      text: formText,
      entities: [
        "PERSON_NAME", "SSN", "DATE_OF_BIRTH",
        "PHONE_NUMBER", "EMAIL_ADDRESS", "ADDRESS"
      ],
      mask_mode: "redact"  // strip identifiers from the copy routed to shared inboxes
    })
  });

  const data = await resp.json();
  return {
    piiTypes: [...new Set(data.detected_entities.map(e => e.type))],
    sanitized: data.anonymized_text,
    count: data.entities_detected
  };
}

gateIntakeSubmission(
  "New PNC: Rosa Marchetti, DOB 11/30/1965, cell 555-882-0417, employment dispute."
).then(console.log);