API de listas restrictivas: verificación contra OFAC por nombre
PlacApi verifica un nombre contra las listas de sanciones de la OFAC del Tesoro de Estados Unidos —la lista Clinton entre ellas— y devuelve en JSON cada coincidencia con su tipo, los programas de sanción que la cobijan, si el nombre encontrado es un alias, los documentos e identificadores que la lista publica y las fechas de nacimiento. Es el paso de listas restrictivas de cualquier proceso de conocimiento del cliente.
¿No eres desarrollador? Consulta el RUNT por placa aquí sin escribir código.
Qué problema resuelve
Las obligaciones de prevención de lavado de activos exigen verificar a clientes y contrapartes contra listas de sanciones, y hacerlo a mano en el buscador del Tesoro no escala ni deja rastro auditable. Esta API resuelve la búsqueda por nombre y devuelve el detalle de cada coincidencia, con la fecha de actualización de las listas para que quede constancia de contra qué versión se verificó.
Para quién sirve
Áreas de cumplimiento y prevención de lavado de activos, fintechs y entidades vigiladas, plataformas de onboarding, y cualquier empresa obligada a hacer debida diligencia sobre sus contrapartes.
Datos requeridos
- nombre — nombre completo de la persona o razón social. La búsqueda es por tokens y no le importa el orden: "PEREZ JUAN" y "Juan Pérez" dan lo mismo.
Fuentes y cobertura
- OFAC — Office of Foreign Assets Control (Departamento del Tesoro de EE. UU.)Listas de sanciones SDN y consolidada, con sus alias: nombre, tipo de entidad, programas de sanción, documentos e identificadores publicados y fechas de nacimiento.
¿Cómo verificar la lista Clinton por API?
Con una llamada POST a /api/listas-restrictivas enviando el nombre completo. La respuesta indica en JSON si aparece en las listas de OFAC —la lista Clinton es parte de ellas— y, si hay coincidencias, el detalle de cada una con sus programas de sanción y sus identificadores.
¿Por qué se busca por nombre y no por cédula?
Porque las listas de sanciones son internacionales y no se indexan por documento colombiano. Lo que sí traen, cuando existe, es el número de documento dentro de las observaciones de cada registro, y por eso se devuelve en `documentos`: sirve para descartar homónimos.
Ejemplo de solicitud
POST https://placapi.com/api/listas-restrictivas. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.
curl -X POST 'https://placapi.com/api/listas-restrictivas' \
-H 'x-api-key: pk_live_TU_CLAVE' \
-H 'content-type: application/json' \
-d '{"nombre":"JUAN PEREZ GOMEZ"}'Ejemplo de respuesta
Respuesta JSON (fragmento con los campos de esta consulta; la API integral devuelve todas las fuentes en el mismo objeto).
{
"source": "listas-restrictivas",
"status": "ok",
"data": {
"nombreConsultado": "JUAN PEREZ GOMEZ",
"tieneAntecedentes": false,
"descripcion": "No aparece en las listas de sanciones",
"enListas": false,
"totalCoincidencias": 0,
"coincidencias": [],
"listaActualizada": "2026-08-11T00:00:00.000Z"
}
}Explicación campo por campo
| Campo | Tipo | Descripción |
|---|---|---|
| enListas | boolean | La respuesta de un vistazo: si el nombre coincide con algún registro sancionado. |
| coincidencias[] | array | Cada coincidencia con su nombre tal como lo publica la lista, tipo, programas de sanción, si es un alias, documentos e identificadores y fechas de nacimiento. |
| coincidencias[].esAlias | boolean | Si el nombre que coincidió es un alias y no el nombre principal. Cambia cómo se interpreta el hallazgo. |
| coincidencias[].documentos | array | Documentos que la lista publica de esa entidad, incluida la cédula colombiana cuando la trae. Es lo que permite descartar un homónimo. |
| listaActualizada | string | Cuándo se descargaron las listas. Deja constancia auditable de contra qué versión se verificó. |
Tiempo de respuesta
Menos de un segundo: las listas se descargan y se buscan localmente, sin consultar a ningún portal en cada petición.
Precio y cobro
1 crédito por consulta con datos, desde 349 COP. El precio por crédito baja por volumen: 349 COP desde 30, 249 COP desde 1.000, 149 COP desde 5.000, 139 COP desde 10.000, 119 COP desde 20.000, 99 COP desde 50.000. Los créditos se compran por adelantado (mínimo 30 = 10.470 COP), no vencen y no hay mensualidad. El mismo precio aplica por la web y por API. Solo se cobra cuando la consulta devuelve datos; por API, las consultas sin resultado (404) tienen 10 gratis al mes por cada tipo de respuesta sin datos y después cobran igual.
Caché y actualización
24 horas. Las listas se actualizan con frecuencia y una verificación de cumplimiento tiene que hacerse contra la versión vigente.
Seguridad y privacidad
La placa y el documento se usan solo para ejecutar la consulta; el resultado queda en caché temporal. No se almacenan datos de tarjetas (los pagos los procesa Wompi). Ver privacidad y seguridad.
Limitaciones y posibles errores
- Se consulta por NOMBRE, no por documento: las listas internacionales no se indexan por cédula colombiana, porque una lista global no puede depender del documento de un país.
- Un nombre común puede producir HOMÓNIMOS. Los campos `documentos` y `fechasNacimiento` de cada coincidencia son los que permiten descartarlos; una coincidencia de nombre no es una identificación.
- Cubre las listas de OFAC. Otras listas de sanciones (ONU, Unión Europea) no están incluidas hoy.
- Una respuesta "no aparece en las listas" COBRA: es exactamente el dato que exige el proceso de cumplimiento.
Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.
Otras preguntas frecuentes
¿Cómo distingo una coincidencia real de un homónimo?
+
Comparando los campos `documentos` y `fechasNacimiento` de la coincidencia contra los de tu cliente. Una coincidencia de nombre es una alerta para revisar, no una identificación; la API entrega los datos para resolverla, no el veredicto.
¿Qué listas cubre?
+
Las de OFAC, el organismo del Tesoro de Estados Unidos: la SDN y la consolidada, incluyendo alias. Las listas de la ONU y de la Unión Europea no están incluidas por ahora.
Seguir explorando
Última revisión: 20 de agosto de 2026 · Versión de la API: v1 · Fuentes y metodología