Gestión de Clientes
Gestiona personas físicas y morales desde la API
Crea, consulta y administra perfiles de clientes. El punto de partida para cualquier flujo de verificación en Singula.
Gestión de Clientes
Persona Física
Persona Moral
Customer ID
cus_lzk9m4ab3f9c2d1e
Listo para verificar
Dos tipos de persona, una sola API
Persona Física
Individuos con nombre, CURP, fecha de nacimiento y datos de contacto.
Persona Moral
Empresas con razón social, nombre comercial y representante legal.
¿Cómo funciona?
Paso 1
Crea el cliente
POST con datos básicos. Recibes un ID único formato cus_xxx listo para usar.
Paso 2
Ejecuta verificaciones
Usa el customer_id para CURP, RFC, KYC, blacklist y cualquier herramienta.
Paso 3
Consulta el perfil
GET para ver el perfil completo con historial de verificaciones.
customers.sh
// Crear persona física
curl -X POST https://api.singula.mx/v1/customers \
-H "Authorization: Bearer sk_live_..." \
-d '{ "name": "Maria", "last_name": "Garcia",
"gender": "M", "birth_day": "15",
"birth_month": "03", "birth_year": "1990" }'
→ { "id": "cus_lzk9m4ab3f9c2d1e", "status": "created" }
// Crear persona moral
curl -X POST https://api.singula.mx/v1/customers/moral \
-d '{ "name": "Tech SA", "legal_name": "Tech SA de CV" }'
→ { "id": "cus_mrl8k2bc4e7f3a9d", "type": "moral" }IDs únicos time-sortable
Formato cus_xxx optimizado para performance en base de datos.
Búsqueda y paginación
Busca clientes por nombre, email o ID con paginación nativa.
Sandbox y producción
Ambientes separados. Misma estructura, datos aislados.
Respuesta instantánea
Creación síncrona en menos de 200ms.