> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # API de licencia de conducir de Estados Unidos (DMV) > Valida licencias de conducir de Estados Unidos (DMV) en fuentes oficiales con Didit. Pago por consulta desde $1.99, sin contratos ni mínimos. Verifica una licencia de conducir o una tarjeta de identificación estatal de EE. UU. frente a los registros del departamento de vehículos motorizados del estado emisor, confirmando el número de licencia, el nombre y apellidos del titular y la fecha de nacimiento. Didit ofrece este servicio a través de `POST /v3/database-validation/` para que puedas verificar los datos enviados frente a la fuente oficial y recibir resultados de coincidencia normalizados. Formato de entrada: `document_number` recibe el número de licencia de conducir o tarjeta de identificación estatal de EE. UU. (4-20 letras y dígitos; se permiten guiones y espacios). ## Cobertura * **Cobertura:** \~ 90% * **País:** Estados Unidos * **ID de servicio:** `usa_driver_license_dmv` * **Dominio de datos:** Documento * **Categoría:** DriverLicence ## Datos de entrada | Campo | Obligatorio | Ejemplo | | - | -: | - | | `first_name` | Sí | `John` | | `last_name` | Sí | `Doe` | | `document_number` | Sí | `SAMPLE-DOC-12345` | | `driver_license_state` | Sí | `Sample State` | | `middle_name` | No | `Demo` | | `date_of_birth` | No | `1990-01-01` | | `date_of_issue` | No | `1990-01-01` | | `expiration_date` | No | `1990-01-01` | | `gender` | No | `M` | | `document_type` | No | `DL` | | `vendor_data` | No | `user-1234` | * **Datos de entrada obligatorios:** `first_name`, `last_name`, `document_number`, `driver_license_state` * **Datos de entrada opcionales:** `middle_name`, `date_of_birth`, `date_of_issue`, `expiration_date`, `gender`, `document_type`, `vendor_data` * **Consentimiento:** No se requiere * **Disponibilidad en el flujo:** Disponible en el flujo de verificación (workflow) * **Cobertura:** \~ 90% * **Precio:** \$1.99 por consulta exitosa ## Parámetros del cuerpo **issuing\_state** `string` *required* (default: USA) Código de país ISO 3166-1 alfa-3 para este servicio de base de datos. Ejemplo: `USA` **services** `string` *required* (default: usa\_driver\_license\_dmv) Array que contiene este ID de servicio. Fijar el servicio mantiene la solicitud limitada a esta base de datos exacta. Ejemplo: `usa_driver_license_dmv` **first\_name** `string` *required* (default: John) Nombre de pila a validar. Ejemplo: `John` **last\_name** `string` *required* (default: Doe) Apellido a validar. Ejemplo: `Doe` **document\_number** `string` *required* (default: SAMPLE-DOC-12345) Número de documento extraído o proporcionado por el usuario. Ejemplo: `SAMPLE-DOC-12345` **driver\_license\_state** `string` *required* (default: Sample State) Estado o región que emitió la licencia de conducir. Ejemplo: `Sample State` **middle\_name** `string` Segundo nombre, cuando esté disponible. Ejemplo: `Demo` **date\_of\_birth** `string` Fecha de nacimiento en formato `YYYY-MM-DD`. Ejemplo: `1990-01-01` **date\_of\_issue** `string` Valor de `date_of_issue` requerido por este servicio de base de datos. Ejemplo: `1990-01-01` **expiration\_date** `string` Valor de `expiration_date` requerido por este servicio de base de datos. Ejemplo: `1990-01-01` **gender** `string` Valor de género, cuando lo requiera la base de datos. Valores permitidos: `M` (masculino), `F` (femenino), `X` (otro o desconocido). Ejemplo: `M` **document\_type** `string` Tipo de documento a validar frente a este servicio de base de datos. Valores permitidos: `DL` (licencia de conducir), `ID` (documento de identidad nacional). Ejemplo: `DL` **vendor\_data** `string` (default: user-1234) Tu referencia de usuario estable para esta persona, como tu ID de usuario interno. Didit la utiliza 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 * Número de licencia de conducir o identificación estatal de EE. UU. (4-20 letras y dígitos; se permiten guiones y espacios) * `document_number` debe tener entre 4 y 20 caracteres de longitud. * `document_number` debe coincidir con `[A-Za-z0-9][A-Za-z0-9 -]{2,18}[A-Za-z0-9]`. * Envía `driver_license_state` como el código de dos letras del estado emisor (`TX`) o su nombre (`Texas`). * Las licencias de California y Pensilvania no se verifican con este servicio. ## Cómo invocar la API ```bash cURL theme={null} curl -X POST "https://verification.didit.me/v3/database-validation/" \ -H "x-api-key: YOUR_API_KEY" \ -F "issuing_state=USA" \ -F "services=usa_driver_license_dmv" \ -F "vendor_data=user-1234" \ -F "first_name=John" \ -F "last_name=Doe" \ -F "document_number=SAMPLE-DOC-12345" \ -F "driver_license_state=Sample State" ``` ```python Python theme={null} from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.database_validation.validate( issuing_state="USA", services=["usa_driver_license_dmv"], first_name="John", last_name="Doe", document_number="SAMPLE-DOC-12345", driver_license_state="Sample State", vendor_data="user-1234", ) print(result) ``` ```javascript Node.js theme={null} import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.databaseValidation.validate({ issuing_state: "USA", services: ["usa_driver_license_dmv"], first_name: "John", last_name: "Doe", document_number: "SAMPLE-DOC-12345", driver_license_state: "Sample State", vendor_data: "user-1234", }); console.log(result); ``` ```go Go theme={null} ctx := context.Background() // Reads DIDIT_API_KEY. client := didit.NewClient() result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{ IssuingState: "USA", Services: didit.Some([]string{"usa_driver_license_dmv"}), FirstName: didit.String("John"), LastName: didit.String("Doe"), DocumentNumber: didit.String("SAMPLE-DOC-12345"), DriverLicenseState: didit.String("Sample State"), VendorData: didit.String("user-1234"), }) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", result) ``` ```java Java theme={null} import java.util.List; import me.didit.Didit; import me.didit.types.DatabaseValidationValidateParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder() .issuingState("USA") .services(List.of("usa_driver_license_dmv")) .firstName("John") .lastName("Doe") .documentNumber("SAMPLE-DOC-12345") .driverLicenseState("Sample State") .vendorData("user-1234") .build()); System.out.println(result); ``` ```php PHP theme={null} databaseValidation->validate([ 'issuing_state' => 'USA', 'services' => ['usa_driver_license_dmv'], 'first_name' => 'John', 'last_name' => 'Doe', 'document_number' => 'SAMPLE-DOC-12345', 'driver_license_state' => 'Sample State', 'vendor_data' => 'user-1234', ]); print_r($result->toArray()); ``` ```ruby Ruby theme={null} require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.database_validation.validate( issuing_state: "USA", services: ["usa_driver_license_dmv"], first_name: "John", last_name: "Doe", document_number: "SAMPLE-DOC-12345", driver_license_state: "Sample State", vendor_data: "user-1234" ) puts result.to_h ``` ```csharp .NET theme={null} using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams { IssuingState = "USA", Services = new string[] { "usa_driver_license_dmv" }, FirstName = "John", LastName = "Doe", DocumentNumber = "SAMPLE-DOC-12345", DriverLicenseState = "Sample State", VendorData = "user-1234", }); Console.WriteLine(JsonSerializer.Serialize(result)); ``` Cada llamada exitosa devuelve HTTP `200`. El campo **`outcome_code`** te indica lo que realmente ocurrió, distinguiendo, por ejemplo, una falta de coincidencia biométrica real (`BIOMETRIC_NO_MATCH`) de una selfie que no se pudo leer (`BIOMETRIC_IMAGE_UNUSABLE`). El `status` que se muestra es el estado predeterminado de la función; tus [acciones de coincidencia parcial / sin coincidencia](https://docs.didit.me/es/core-technology/database-validation/database-validation-warnings.md) configuradas pueden anularlo. **`MATCH`** — El registro confirmó la identidad y todos los campos verificados coincidieron. ```json 200 OK — MATCH theme={null} { "request_id": "req_01H…", "status": "Approved", "issuing_state": "USA", "match_type": "full_match", "validations": [ { "outcome_code": "MATCH", "service_id": "usa_driver_license_dmv", "service_name": "United States - Driver's License (DMV)", "source_data": { "date_of_birth": "1990-01-01", "first_name": "John", "identification_number": "SAMPLE-ID-12345", "last_name": "Doe", "middle_name": "Demo" }, "validation": { "full_name": "full_match", "identification_number": "full_match" } } ] } ``` **`PARTIAL_MATCH`** — Se encontró el número de identificación, pero uno o más campos personales (normalmente el nombre o la fecha de nacimiento) no coincidieron por completo. ```json 200 OK — PARTIAL_MATCH theme={null} { "request_id": "req_01H…", "status": "In Review", "issuing_state": "USA", "match_type": "partial_match", "validations": [ { "outcome_code": "PARTIAL_MATCH", "service_id": "usa_driver_license_dmv", "service_name": "United States - Driver's License (DMV)", "source_data": { "date_of_birth": "1990-01-01", "first_name": "John", "identification_number": "SAMPLE-ID-12345", "last_name": "Doe", "middle_name": "Demo" }, "validation": { "full_name": "no_match", "identification_number": "full_match" } } ] } ``` **`NO_MATCH`** — El registro no devolvió ninguna coincidencia para los datos enviados. ```json 200 OK — NO_MATCH theme={null} { "request_id": "req_01H…", "status": "Declined", "issuing_state": "USA", "match_type": "no_match", "validations": [ { "outcome_code": "NO_MATCH", "service_id": "usa_driver_license_dmv", "service_name": "United States - Driver's License (DMV)", "source_data": { "full_name": "NO_MATCH", "identification_number": "NO_MATCH" }, "validation": { "full_name": "no_match", "identification_number": "no_match" } } ] } ``` ## Datos devueltos Los campos exactos mostrados en `source_data` dependen de lo que devuelva el registro. El ejemplo generado para `usa_driver_license_dmv` documenta actualmente esta estructura normalizada: * `date_of_birth` * `first_name` * `identification_number` * `last_name` * `middle_name` ## Precios y SLA Las consultas de United States - Driver's License (DMV) se facturan únicamente cuando Didit recibe un resultado concluyente de la fuente de validación. * **Precio por llamada:** \$1.99 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ípica \< 2 s. * **Disponibilidad:** 99.9% por trimestre por parte de Didit; la disponibilidad de la fuente subyacente varía según el país y el conjunto de datos. ## Seguir leyendo * [Visión general de la validación de base de datos de Estados Unidos](https://docs.didit.me/api-reference/database-validation/united-states.md) * [Visión general de la validación de base de datos](https://docs.didit.me/es/core-technology/database-validation/overview.md) * [Códigos de resultado](https://docs.didit.me/es/core-technology/database-validation/database-validation-outcome-codes.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.