API de personas políticamente expuestas para empresas

Qué devuelve cada consulta

Cada consulta devuelve una lista de hasta 50 candidatos. De cada candidato recibes su cargo, la fuente de donde sale, un porcentaje de coincidencia, las razones por las que apareció, lo que conviene verificar para descartarlo y la evidencia que lo respalda. Los candidatos vienen en dos grupos, según qué tan alta es la coincidencia.

La decisión es de quien consulta. Entitymx muestra candidatos y la evidencia de cada uno, y tu empresa los compara con su expediente para resolver si se trata de la misma persona. Cada candidato trae además una recomendación de tratamiento, que es una sugerencia para verificar y no una afirmación de identidad.

Si lo pides en la misma consulta, recibes también la constancia de la búsqueda, que es el comprobante de lo que se consultó y de lo que se obtuvo. No cuesta aparte.

Qué datos enviar

Es obligatorio el nombre y el primer apellido, ya sea en un solo campo con el nombre completo o separados en nombres, primer apellido y, si lo tienes, segundo apellido. Para afinar la coincidencia puedes agregar la fecha de nacimiento o solo el año, y la entidad.

La CURP y el RFC son opcionales: puedes enviar uno de los dos, nunca ambos. De ellos solo se comparan los 10 primeros caracteres, que son las 4 siglas del nombre y la fecha de nacimiento. La CURP y el RFC que envías no se guardan: solo se usan durante la consulta, y en la bitácora queda el nombre del campo, no su valor.

La consulta lleva tu llave en la cabecera Authorization y una clave de petición en la cabeceraIdempotency-Key, distinta en cada búsqueda. La API tiene una sola operación, POST /v1/match, con el cuerpo en JSON, y acepta hasta 5 búsquedas por segundo por cuenta, sumando las del sitio y las de la API.

La documentación técnica completa, con la petición, la respuesta, los errores y un ejemplo, está endocumentación de la API.

Cuánto cuesta

El acceso a la API tiene una suscripción de $6,500.00 mxn al mes con IVA incluido. Además, cada consulta usa una búsqueda de tu saldo, a $6.00 mxn con IVA incluido, el mismo saldo que compras para el buscador del sitio. Las búsquedas compradas no vencen. Las reglas completas están enprecios.

Cada consulta se cobra según lo que responde el servicio:

• Una consulta que el servicio ejecuta, traiga candidatos o no.
• Una consulta repetida, aunque use la misma llave de petición.
• Una consulta mal formada que el servicio rechaza.

Y no se cobra:

• Una consulta sin llave válida o sin permiso.
• Una consulta sin saldo.
• Una consulta rechazada por exceder el límite de ritmo.
• Una consulta que falla por un error del servicio.
• La constancia, si se pide en la misma consulta.

Cómo se obtiene el acceso

1. Crea tu cuenta.
2. Suscríbete a la API y paga la suscripción mensual con tarjeta. Al confirmarse el pago, tu cuenta queda con acceso.
3. Genera tu llave en tu página de API y elige su vigencia, de 30 días a un año. La llave se muestra una sola vez.

Las fuentes que se monitorean, con su estado medido y sus huecos declarados, están encobertura. Las dudas más comunes están enpreguntas frecuentes.