Saltar al contenido principal
POST
El Social Security Death Master File oficial. Didit ofrece este servicio a través de POST /v3/database-validation/ para que puedas verificar los datos enviados contra la fuente oficial y recibir resultados de coincidencia normalizados.

Cobertura

  • Cobertura: 100%*
  • País: Estados Unidos
  • ID del servicio: usa_states_death_check
  • Dominio de datos: Otro
  • Categoría: DeathRecord

Datos de entrada

  • Datos obligatorios: first_name, last_name
  • Datos opcionales: middle_name, date_of_birth, ssn, vendor_data
  • Consentimiento: No es necesario
  • Disponibilidad en flujos: Disponible en el flujo de trabajo
  • Cobertura: 100%*
  • Precio: $0.06 por consulta exitosa

Parámetros del cuerpo

string
predeterminado:"USA"
requerido
Código de país ISO 3166-1 alpha-3 de este servicio de base de datos.Ejemplo: USA
string
predeterminado:"usa_states_death_check"
requerido
Array que contiene el ID de este servicio. Fijar el servicio limita la solicitud a esta base de datos concreta.Ejemplo: usa_states_death_check
string
predeterminado:"John"
requerido
Nombre de pila que se va a validar.Ejemplo: John
string
predeterminado:"Doe"
requerido
Apellido que se va a validar.Ejemplo: Doe
string
Segundo nombre, cuando esté disponible.Ejemplo: Demo
string
Fecha de nacimiento en formato YYYY-MM-DD.Ejemplo: 1990-01-01
string
Valor de ssn que requiere este servicio de base de datos.Ejemplo: 123456789
string
predeterminado:"user-1234"
Tu referencia estable de usuario para esta persona, como tu ID de usuario interno. Didit la usa para vincular las comprobaciones independientes al mismo usuario final y reducir el ruido en la detección de duplicados.Ejemplo: user-1234

Reglas de entrada y notas de validación

  • Número de la Seguridad Social (SSN) o ITIN de EE. UU.: los 9 dígitos completos (guiones opcionales) o solo los 4 últimos dígitos
  • ssn debe coincidir con (?:\d{9}|\d{3}-\d{2}-\d{4}|\d{4}).
  • Para ssn, envía el SSN/ITIN completo de 9 dígitos (guiones opcionales) o solo sus 4 últimos dígitos.

Cómo invocarlo

Datos devueltos

Los campos exactos que aparecen en source_data dependen de lo que devuelva el registro. El ejemplo generado para usa_states_death_check documenta actualmente esta estructura normalizada:
  • date_of_birth
  • first_name
  • full_name
  • last_name
  • name_match_score

Precios y SLA

Las consultas de Estados Unidos de América - United States Death Check (SSDMF) solo se facturan cuando Didit recibe un resultado concluyente de la fuente de validación.
  • Precio por llamada: $0.06 USD.
  • Facturación: por consulta exitosa. No se te cobra cuando no se puede acceder al registro, cuando faltan campos obligatorios o cuando la solicitud se rechaza antes de llegar a la fuente.
  • Latencia: p95 típico < 2 s.
  • Disponibilidad: 99.9% por trimestre por parte de Didit; la disponibilidad de la fuente externa varía según el país y el conjunto de datos.

Continúa leyendo

Última modificación el 1 de noviembre de 2026