# PLICA Forensic API — documentation index
# https://api.plicaforensic.com/docs
# Updated: June 2026

> Evidence-first document forensics for regulated file workflows.
> Plugs into your KYC stack — does not replace Sumsub, Onfido, or Veriff.

## Product docs (HTML)

- [Platform overview](https://api.plicaforensic.com/docs/index.html): architecture, forensic modules, positioning
- [Getting started](https://api.plicaforensic.com/docs/getting-started.html): API keys, first request, trial sandbox
- [POST /verify](https://api.plicaforensic.com/docs/verify-api.html): images + PDF, parameters, modes, document scan routing
- [POST /verify-unified](https://api.plicaforensic.com/docs/verify-unified-api.html): single endpoint for images and PDFs
- [Async /jobs](https://api.plicaforensic.com/docs/jobs-api.html): batch upload, poll, webhooks
- [Response format](https://api.plicaforensic.com/docs/responses.html): verdicts, analyst_summary, tamper_regions, PDF embedded fields
- [Evidence lifecycle](https://api.plicaforensic.com/docs/evidence-lifecycle.html): intake hash, custody, honest status labels

## API reference

- OpenAPI schema: https://api.plicaforensic.com/openapi.json
- Health: GET /api/v1/health
- Trial signup: /api-trial · Sandbox UI: /try
- Trial report JSON: GET /api/v1/trial/report/{analysis_id}
- Forensic PDF download: GET /api/v1/trial/report/{analysis_id}/pdf?mode=short|detail

## Shipped capabilities (June 2026)

- Document scan routing: preserve_exif=true on flat JPEG/PNG → document_fraud_hint, Layer 1 local inconsistency maps
- details.tamper_regions[] — localized edit candidates (bbox, score, rank_score, methods, area_pct)
- analyst_summary.generation_rule document_localized_edit — HITL on region signal when global tamper is low
- PDF verify: container forensics + embedded raster pixel analysis (largest raster default, not first-in-file-order)
- PDF forensic reports: Analyzed Evidence shows source PDF metadata only — no embedded raster thumbnail
- presentation sync: business_view.top_indicators aligned with key_indicators for document_localized_edit / intrinsic_borderline

## What PLICA is NOT (scope)

- Not a full-stack KYC/KYB platform (no hosted liveness sessions, no AML watchlist screening)
- Not proof of pre-intake authenticity — chain of custody starts at API boundary
- Not auto-deny by metadata lineage alone — review escalation signals
- tamper_regions coordinates are analyst hints — not legal proof of edit location

## Engineering (repo)

- Layer 1 spec: docs/02-detection/local-inconsistency-maps-p0.md
- Evidence seal threat model: docs/03-engineering/api/evidence-seal-threat-model.md
- Policy webhooks: docs/03-engineering/api/policy-enforcement-integration-guide.md
- PDF container forensics: docs/03-engineering/api/pdf-container-forensics-v1-spec.md