Validador de Número de Documento

Verifique si un número de documento está bien formado para su jurisdicción, antes de crear una sesión o enviar una verificación. No se almacena nada y no se consume ninguna verificación.

Endpoint: POST /v1/validators/document-number
Autenticación: token Bearer con el scope sessions

Una verificación de formato sin estado contra el mismo registro que usa el pipeline de verificación. No se almacena nada y no se consume ninguna verificación — pero recibe identificadores gubernamentales, por lo que se atribuye a un tenant como todos los demás endpoints de esta sección. Útil para validar la entrada en su propio formulario antes de crear una sesión.

curl --request POST \
  --url https://{FQDN}/v1/validators/document-number \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
  "documentType": "drivers_license",
  "number": "31612967",
  "issuingCountry": "USA",
  "issuingState": "PA"
}'

{
  "documentType": "drivers_license",
  "issuingCountry": "USA",
  "issuingState": "PA",
  "valid": true,
  "rule": "dl:USA:PA",
  "detail": "document number matches the PA license format"
}

El número que envía nunca se devuelve en la respuesta. La respuesta informa la jurisdicción aplicada, no el identificador que usted envió.

Qué Está Cubierto

Los 11 países adicionales de pasaporte, como el issuingCountry que usted envía: ARG, AUS, CHN, DEU, FRA, GBR, IND, ITA, JPN, NLD, RUS.

Todo lo que no está marcado con ✓ — dentro o fuera de la tabla — devuelve valid: null, nunca false. Trate null como "no lo sabemos": acéptelo, y no lo interprete como aprobación ni rechazo.

La CNH, el CPF y el DNI/NIE se verifican con aritmética real de dígitos de control, por lo que una transposición de dígitos se detecta — a diferencia de las tablas de licencias, que verifican solo la forma, porque esas jurisdicciones no publican dígito de control.

Indicar la Jurisdicción

issuingCountry es el país — un código ISO 3166-1 alpha-3, un nombre de país o un alias común. issuingState es una subdivisión dentro de ese país — un estado de EE. UU. o una provincia o territorio de Canadá — y solo las licencias de conducir la utilizan.

Envíe siempre issuingCountry. Una licencia enviada sin él asume USA para que las integraciones anteriores a issuingCountry sigan funcionando, pero depender de ese fallback es precisamente cómo una licencia no estadounidense termina verificada contra el formato de un estado de EE. UU. Nada más infiere el país: un pasaporte o cédula de identidad sin él devuelve valid: null.

ssn e itin existen solo en el validador. No son tipos de documento capturables — no puede crear una sesión para ellos — pero las reglas estructurales son útiles cuando los recoge en sus propios formularios.

Interpretar la Respuesta

valid es deliberadamente de tres valores:

null es la respuesta honesta para una jurisdicción sin regla, y es la razón por la que las brechas de cobertura siguientes son seguras en lugar de silenciosamente erróneas.

rule nombra la regla aplicada, para que sepa qué jurisdicción respondió:

Errores

El segundo merece una segunda lectura si integró antes de que existiera issuingCountry: issuingState solía llevar el país para pasaportes y cédulas de identidad. Enviarlo de esa forma ahora es un error explícito en lugar de un null silencioso, porque un null interpretado como aprobación es la peor falla.

Próximos Pasos

• Sesiones de Verificación — crear una sesión, y el prefill que usa esta misma verificación
• Sandbox y Datos de Prueba — números reservados que devuelven un veredicto elegido bajo demanda