API REST

Todos los endpoints están bajo https://api.saremi.io/v1/verify/ y requieren el header X-API-Key (ver Autenticación).

Verificación automática (recomendada)

POST /v1/verify/document
Content-Type: multipart/form-data

Envías el archivo y SAREMI detecta el tipo de documento automáticamente (por texto extraído, y si no es suficiente, con clasificación visual). Es el endpoint recomendado para la mayoría de integraciones.

curl -X POST https://api.saremi.io/v1/verify/document \
  -H "X-API-Key: TU_API_KEY" \
  -F "file=@ine_frontal.jpg" \
  -F "client_reference_id=expediente-1234"

Endpoints por tipo de documento

Si ya sabes el tipo de documento, puedes llamar directamente al endpoint específico en vez de /document — evita el paso de auto-detección:

Todos aceptan multipart/form-data con un campo file, y responden el mismo modelo de respuesta que /document.

Registrar antes de analizar (opcional)

POST /v1/verify/pending

Crea un registro en estado processing antes de que termine el análisis — útil si tu flujo necesita mostrar “en revisión” de inmediato. Devuelve { "id": "..." }, que puedes pasar como pending_id a la llamada real.

Modelo de respuesta

Todos los endpoints de verificación devuelven el mismo objeto:

{
  "document_type": "ine",
  "status": "verified",
  "confidence_score": 0.925,
  "extracted_data": {
    "full_name": "JUAN PÉREZ LÓPEZ",
    "curp": "PELJ800101HDFRPN09"
  },
  "checks": [
    { "name": "curp_format", "status": "passed", "detail": "El formato del CURP es válido" }
  ],
  "conclusion": "Documento verificado correctamente...",
  "warnings": [],
  "fraud_flags": [
    {
      "code": "AI_GENERATED",
      "severity": "critical",
      "description": "El documento presenta patrones consistentes con generación por IA",
      "source_check": "image_authenticity"
    }
  ],
  "processing_time_ms": 18432
}