Saltar al contenido principal
POST
Servicio agregado de registros gubernamentales y públicos, registros de antecedentes y otros servicios. 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: ~ 85%
  • País: Estados Unidos
  • ID del servicio: usa_states_financial_services
  • Dominio de datos: Financiero
  • Categoría: FinancialServices

Datos de entrada

  • Datos obligatorios: first_name, last_name, date_of_birth
  • Datos opcionales: address.street_1, address.street_2, address.city, address.region, address.postal_code, phone, ssn, email, vendor_data
  • Consentimiento: No se requiere
  • Disponibilidad en el workflow: Disponible en el workflow
  • Cobertura: ~ 85%
  • Precio: $0.20 por consulta exitosa

Parámetros del cuerpo

string
predeterminado:"USA"
requerido
Código de país ISO 3166-1 alfa-3 para este servicio de base de datos.Ejemplo: USA
string
predeterminado:"usa_states_financial_services"
requerido
Array que contiene este ID de servicio. Fijar el servicio limita la solicitud a esta base de datos exacta.Ejemplo: usa_states_financial_services
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
predeterminado:"1990-01-01"
requerido
Fecha de nacimiento en formato YYYY-MM-DD.Ejemplo: 1990-01-01
object
Objeto estructurado con la dirección de residencia. Usa street_1, street_2, city, region, postal_code y country. Todavía se acepta una cadena de dirección completa en el formato heredado, pero no se recomienda.Ejemplo: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
Número de teléfono en formato internacional.Ejemplo: +15550101000
string
Valor de ssn requerido por este servicio de base de datos.Ejemplo: 123456789
string
Dirección de correo electrónico.Ejemplo: john.doe@example.com
string
predeterminado:"user-1234"
Tu referencia estable de usuario para esta persona, como tu ID de usuario interno. Didit la usa para vincular verificaciones 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

  • address es opcional para este servicio. Puedes enviar una cadena address completa y Didit la dividirá en elementos de dirección estructurados cuando sea posible, o puedes enviar los campos estructurados de forma explícita.
  • Número de Seguro Social (SSN) o ITIN de EE. UU.: los 9 dígitos completos (guiones opcionales) o solo los últimos 4 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 últimos 4 dígitos.
  • Este servicio requiere first_name, last_name y date_of_birth, lo que ya cumple el mínimo exigido por la fuente: un nombre más otro campo de identidad. Los campos opcionales (ssn, address, phone, email) refuerzan aún más la coincidencia.
  • En los servicios de dirección, envía campos de dirección estructurados en lugar de una sola cadena address siempre que sea posible.
  • address.street_1 es la dirección, incluidos el número y el tipo de vía.
  • address.street_2 es el apartamento, la unidad, el edificio, la planta o una línea de dirección adicional. Envíalo solo cuando lo tengas.
  • address.city es la ciudad, el suburbio, el distrito, la localidad o el vecindario.
  • address.region es el estado, la provincia, la región o la localidad.
  • address.postal_code es el código postal.
  • Los servicios de base de datos basados en dirección requieren como mínimo la dirección de la calle y el código postal; las solicitudes rechazadas antes de la consulta a la fuente no se cobran.

Cómo invocar la API

Datos devueltos

Los campos exactos que aparecen en source_data dependen de lo que devuelva el registro de empresas. El ejemplo generado para usa_states_financial_services documenta actualmente esta estructura normalizada:
  • address
  • address_match_score
  • city
  • date_of_birth
  • first_name
  • full_name
  • last_name
  • name_match_score
  • postal_code
  • state
  • street

Precios y SLA

Las consultas de Estados Unidos de América - Servicios financieros de Estados Unidos solo se facturan cuando Didit recibe un resultado concluyente de la fuente de validación.
  • Precio por llamada: $0.20 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 habitual < 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