Certificado de antecedentes penales
Extrae los datos del certificado de antecedentes penales (DIJ).
Petición
multipart/form-data con un solo campo:
| Campo | Tipo | Descripción |
|---|---|---|
file | archivo | JPEG, PNG, WEBP, GIF o PDF. Máximo 10 MB. Obligatorio. |
curl
curl https://www.istmobot.com/api/v1/antecedentes-penales \ -H "Authorization: Bearer ib_live_..." \ -F file=@documento.png
JavaScript
const form = new FormData();
form.append("file", fileBlob, "documento.png");
const res = await fetch("https://www.istmobot.com/api/v1/antecedentes-penales", {
method: "POST",
headers: { Authorization: "Bearer ib_live_..." },
body: form,
});
const { data, meta } = await res.json();Respuesta
200 con data según la tabla y meta (request_id, credits_used, plugin_version, sandbox). Campos ausentes en el documento llegan como null.
| Campo | Tipo | Descripción |
|---|---|---|
nombre | string | null | Nombre completo de la persona |
cedula | string | null | Cédula o pasaporte, ej. 8-123-456 |
tiene_antecedentes | boolean | null | false si el certificado dice que no registra antecedentes |
fecha_emision | string | null | Fecha de emisión, yyyy-mm-dd |
numero_certificado | string | null | Número del certificado |
codigo_verificacion | string | null | Código de verificación impreso |
Ejemplo
{ "data": { "nombre": "JOSÉ ANTONIO PÉREZ GÓMEZ", "cedula": "8-123-456", "tiene_antecedentes": false, "fecha_emision": "2026-09-10", "numero_certificado": "DIJ-2026-00123456", "codigo_verificacion": "X9Y8Z7" }, "meta": { "request_id": "req_3f9c2a", "credits_used": 2, "plugin_version": "0.1.0", "sandbox": false } }
Con una key ib_test_ recibes exactamente este data con credits_used: 0 y sandbox: true.
Errores
401 key inválida · 402 sin créditos · 422 entrada inválida o extracción fallida · 429 rate limit. Formato en Errores.
istmobot