F
FULLSCAN
Documentación API

API de Screening

Consulta de debida diligencia LA/FT en 69+ fuentes

Inicio Rápido

curl -X POST https://fullscan.hitonetap.com/api/v1/screening \
  -H "x-api-key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"docType": "CC", "docNumber": "1129565595"}'

Autenticación

Todas las requests requieren un API key en el header x-api-key.

Obtén tu API key en Configuración → API.

Endpoints

POST/api/v1/screening

Ejecuta screening completo en 69+ fuentes

Request Body

{
  "docType": "CC",        // CC, CE, NIT, PA, NOM
  "docNumber": "1129565595",
  "fullName": "NOMBRE"    // opcional, se resuelve automáticamente
}

Response

{
  "success": true,
  "data": {
    "id": "abc123",
    "fullName": "THOMAS MICHEL JANNA ABISAAD",
    "riskScore": 96,
    "riskLevel": "bajo",
    "confidence": 90,
    "summary": {
      "totalSources": 69,
      "clean": 63, "warning": 1, "info": 5, "danger": 0
    },
    "sources": [
      { "key": "ofac_sdn", "name": "OFAC", "status": "clean", ... }
    ]
  }
}
POST/api/screening/batch

Consulta masiva (máx. 50 documentos)

{
  "documents": [
    { "docType": "CC", "docNumber": "1129565595" },
    { "docType": "NIT", "docNumber": "900257147" }
  ]
}
POST/api/screening/pdf

Genera informe PDF completo. Retorna HTML para imprimir/guardar.

POST/api/reportes/sirel

Genera reportes SIREL ROS/AROS para la UIAF

POST/api/reportes/manual

Genera manuales SAGRILAFT/PTEE personalizados con IA

Ejemplos de Código

Python

import requests

response = requests.post(
    "https://fullscan.hitonetap.com/api/v1/screening",
    headers={"x-api-key": "TU_API_KEY", "Content-Type": "application/json"},
    json={"docType": "CC", "docNumber": "1129565595"}
)
data = response.json()
print(f"Score: {data['data']['riskScore']}")
print(f"Level: {data['data']['riskLevel']}")

JavaScript

const res = await fetch("https://fullscan.hitonetap.com/api/v1/screening", {
  method: "POST",
  headers: { "x-api-key": "TU_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ docType: "CC", docNumber: "1129565595" })
});
const { data } = await res.json();
console.log(`Score: ${data.riskScore}, Level: ${data.riskLevel}`);

Límites

PlanConsultas/mesBatch máx.
Starter5010
Professional20025
Business1,00050
EnterpriseIlimitadas100