PII Detection for Law Enforcement

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": "Victim WHITMORE, Dana (DOB 04/11/1992, OLN TX 40118822) of 1622 Corvid Ln stated her ex-husband violated the protective order. Witness: M. Raman, cell 555-330-9114.",
    "entities": ["PERSON_NAME", "DATE_OF_BIRTH", "DRIVERS_LICENSE_NUMBER", "ADDRESS", "PHONE_NUMBER"],
    "mask_mode": "replace",
    "threshold": 0.4
  }'

import requests

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

RELEASE_ENTITIES = [
    "PERSON_NAME", "ADDRESS", "ZIP_CODE", "PHONE_NUMBER",
    "DATE_OF_BIRTH", "AGE", "SSN", "DRIVERS_LICENSE_NUMBER",
    "GPS_COORDINATES", "MEDICAL_DATA",
]

def scan_transcript(segments: list) -> list:
    # segments: [{"start_ms": 252000, "end_ms": 258000, "text": "..."}, ...]
    full_text = "\n".join(s["text"] for s in segments)
    resp = requests.post(
        API_URL,
        json={
            "api_key": "YOUR_API_KEY",
            "api_type": "pii_detection",
            "text": full_text,
            "entities": RELEASE_ENTITIES,
            "mask_mode": "replace",
            "threshold": 0.4,
            "custom_instruction": "Do not flag officer names or badge numbers spoken in official capacity.",
        },
        timeout=30,
    )
    hits = resp.json()["detected_entities"]
    # Map each hit's char offsets back to the media timestamps for bleeping
    redaction_cues = []
    cursor = 0
    for seg in segments:
        seg_start, seg_end = cursor, cursor + len(seg["text"])
        for e in hits:
            if e["start"] < seg_end and e["end"] > seg_start:
                redaction_cues.append({
                    "type": e["type"],
                    "bleep_from_ms": seg["start_ms"],
                    "bleep_to_ms": seg["end_ms"],
                })
        cursor = seg_end + 1  # account for the joining newline
    return redaction_cues

print(scan_transcript([
    {"start_ms": 252000, "end_ms": 254000, "text": "OFFICER: Can I get your name?"},
    {"start_ms": 254000, "end_ms": 258000, "text": "SPEAKER 2: Marcus Delaine, 3308 Kessler Ave, apartment 4."},
]))

// Verify a report copy is clean before it leaves the records portal
async function verifyReleaseCopy(reportText) {
  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: reportText,
      entities: [
        "PERSON_NAME", "ADDRESS", "PHONE_NUMBER",
        "DATE_OF_BIRTH", "SSN", "DRIVERS_LICENSE_NUMBER"
      ],
      mask_mode: "redact",
      threshold: 0.4,
      custom_instruction: "Officer names in official capacity are releasable; do not flag them."
    })
  });

  const data = await resp.json();
  if (data.entities_detected > 0) {
    // Residual identifiers found — block release, return spans to the reviewer
    return { release: false, residual: data.detected_entities };
  }
  return { release: true };
}

verifyReleaseCopy("Redacted copy text of report 26-044812...").then(console.log);