MVE API v2

Evidence-based verification — four verdict classes, independent evidence graph, patch localization.

Base URL

https://mve.evynum.com/api/v2

Example — POST /api/v2/verify

curl -X POST "https://mve.evynum.com/api/v2/verify?mode=deep" \
  -F "file=@photo.jpg"

{
  "verification_id": "EVY-...",
  "verdict": "verified_authentic",
  "confidence": "high",
  "evidence_strength": "strong",
  "regions": [],
  "evidence_graph": { "nodes": [...] },
  "limitations": []
}

Endpoints

POST/api/v2/verify?mode=quick|deep|forensicEvidence graph verification (recommended)

GET/api/v2/jobs/:idPoll v2 job status and retrieve report

GET/api/v2/verifications/:id/reportFull evidence graph report JSON

POST/api/v1/verifyLegacy v1 pipeline (deprecated)

GET/api/v1/jobs/:idPoll legacy job status

POST/api/v1/webhooksRegister webhook for verification.completed

Webhook Payload

{
  "event": "verification.completed",
  "verification_id": "EVY-...",
  "verdict": "likely_ai_generated",
  "confidence": "high",
  "confidence_pct": 73,
  "sha256": "...",
  "timestamp": "2026-08-11T01:30:00Z"
}

Verdict Types

verified_authentic — VERIFIED AUTHENTIC
verified_ai_generated — VERIFIED AI
likely_ai_modified — LIKELY AI / MANIPULATED
inconclusive — INCONCLUSIVE (includes unable to verify)