curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=URY" \
-F "services=ury_cedula" \
-F "vendor_data=user-1234" \
-F "personal_number=1111111" \
-F "date_of_birth=1990-01-01"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="URY",
services=["ury_cedula"],
date_of_birth="1990-01-01",
personal_number="1111111",
vendor_data="user-1234",
)
print(result)
import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "URY",
services: ["ury_cedula"],
date_of_birth: "1990-01-01",
personal_number: "1111111",
vendor_data: "user-1234",
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "URY",
Services: didit.Some([]string{"ury_cedula"}),
DateOfBirth: didit.String("1990-01-01"),
PersonalNumber: didit.String("1111111"),
VendorData: didit.String("user-1234"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.time.LocalDate;
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("URY")
.services(List.of("ury_cedula"))
.dateOfBirth(LocalDate.parse("1990-01-01"))
.personalNumber("1111111")
.vendorData("user-1234")
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'URY',
'services' => ['ury_cedula'],
'date_of_birth' => '1990-01-01',
'personal_number' => '1111111',
'vendor_data' => 'user-1234',
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "URY",
services: ["ury_cedula"],
date_of_birth: "1990-01-01",
personal_number: "1111111",
vendor_data: "user-1234"
)
puts result.to_h
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 = "URY",
Services = new string[] { "ury_cedula" },
DateOfBirth = "1990-01-01",
PersonalNumber = "1111111",
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "URY",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "ury_cedula",
"service_name": "Uruguay - CI verification",
"source_data": {
"date_of_birth": "1990-01-01",
"first_name": "John",
"full_name": "John Doe",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe"
},
"validation": {
"date_of_birth": "full_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "URY",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_MATCH",
"service_id": "ury_cedula",
"service_name": "Uruguay - CI verification",
"source_data": {
"date_of_birth": "1990-01-01",
"first_name": "John",
"full_name": "John Doe",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe"
},
"validation": {
"date_of_birth": "no_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "URY",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "ury_cedula",
"service_name": "Uruguay - CI verification",
"source_data": {
"date_of_birth": "NO_MATCH",
"identification_number": "NO_MATCH"
},
"validation": {
"date_of_birth": "no_match",
"identification_number": "no_match"
}
}
]
}
Validación de base de datos
API de verificación de CI de Uruguay en tiempo real
Valida la cédula de identidad (CI) de Uruguay contra la base de datos oficial con Didit. Pago por consulta desde $0.20, sin contratos ni mínimos.
POST
/
v3
/
database-validation
/
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=URY" \
-F "services=ury_cedula" \
-F "vendor_data=user-1234" \
-F "personal_number=1111111" \
-F "date_of_birth=1990-01-01"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="URY",
services=["ury_cedula"],
date_of_birth="1990-01-01",
personal_number="1111111",
vendor_data="user-1234",
)
print(result)
import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "URY",
services: ["ury_cedula"],
date_of_birth: "1990-01-01",
personal_number: "1111111",
vendor_data: "user-1234",
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "URY",
Services: didit.Some([]string{"ury_cedula"}),
DateOfBirth: didit.String("1990-01-01"),
PersonalNumber: didit.String("1111111"),
VendorData: didit.String("user-1234"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.time.LocalDate;
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("URY")
.services(List.of("ury_cedula"))
.dateOfBirth(LocalDate.parse("1990-01-01"))
.personalNumber("1111111")
.vendorData("user-1234")
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'URY',
'services' => ['ury_cedula'],
'date_of_birth' => '1990-01-01',
'personal_number' => '1111111',
'vendor_data' => 'user-1234',
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "URY",
services: ["ury_cedula"],
date_of_birth: "1990-01-01",
personal_number: "1111111",
vendor_data: "user-1234"
)
puts result.to_h
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 = "URY",
Services = new string[] { "ury_cedula" },
DateOfBirth = "1990-01-01",
PersonalNumber = "1111111",
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "URY",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "ury_cedula",
"service_name": "Uruguay - CI verification",
"source_data": {
"date_of_birth": "1990-01-01",
"first_name": "John",
"full_name": "John Doe",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe"
},
"validation": {
"date_of_birth": "full_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "URY",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_MATCH",
"service_id": "ury_cedula",
"service_name": "Uruguay - CI verification",
"source_data": {
"date_of_birth": "1990-01-01",
"first_name": "John",
"full_name": "John Doe",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe"
},
"validation": {
"date_of_birth": "no_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "URY",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "ury_cedula",
"service_name": "Uruguay - CI verification",
"source_data": {
"date_of_birth": "NO_MATCH",
"identification_number": "NO_MATCH"
},
"validation": {
"date_of_birth": "no_match",
"identification_number": "no_match"
}
}
]
}
Verifica los datos de la cédula uruguaya con los registros oficiales de la Dirección Nacional del Registro de Estado Civil. Didit ofrece este servicio a través de
POST /v3/database-validation/ para que puedas verificar los datos enviados con la fuente oficial y recibir resultados de coincidencia normalizados.
Cobertura
- Cobertura: 90-95%
- País: Uruguay
- ID del servicio:
ury_cedula - Dominio de datos: Identidad
- Categoría: NationalIDRegistry
Datos de entrada
| Campo | Obligatorio | Ejemplo |
|---|---|---|
personal_number | Sí | 1111111 |
date_of_birth | Sí | 1990-01-01 |
first_name | No | John |
last_name | No | Doe |
vendor_data | No | user-1234 |
- Datos obligatorios:
personal_number,date_of_birth - Datos opcionales:
first_name,last_name,vendor_data - Consentimiento: No es necesario
- Disponibilidad en flujos: Disponible en flujos de trabajo
- Cobertura: 90-95%
- Precio: $0.20 por consulta exitosa
Parámetros del cuerpo
string
predeterminado:"URY"
requerido
Código de país ISO 3166-1 alfa-3 de este servicio de base de datos.Ejemplo:
URYstring
predeterminado:"ury_cedula"
requerido
Array que contiene el ID de este servicio. Al fijar el servicio, la solicitud queda limitada a esta base de datos concreta.Ejemplo:
ury_cedulastring
predeterminado:"1111111"
requerido
Número de identidad personal propio de cada país.Ejemplo:
1111111string
predeterminado:"1990-01-01"
requerido
Fecha de nacimiento en formato
YYYY-MM-DD.Ejemplo: 1990-01-01string
Nombre de pila que se va a validar.Ejemplo:
Johnstring
Apellido que se va a validar.Ejemplo:
Doestring
predeterminado:"user-1234"
Tu referencia de usuario estable 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-1234Reglas de entrada y notas de validación
- CI uruguaya (de 7 a 9 dígitos)
personal_numbersolo debe contener dígitos; elimina los espacios, guiones y signos de puntuación antes de enviar la solicitud.personal_numberdebe tener entre 7 y 9 caracteres.
Cómo invocarlo
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=URY" \
-F "services=ury_cedula" \
-F "vendor_data=user-1234" \
-F "personal_number=1111111" \
-F "date_of_birth=1990-01-01"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="URY",
services=["ury_cedula"],
date_of_birth="1990-01-01",
personal_number="1111111",
vendor_data="user-1234",
)
print(result)
import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "URY",
services: ["ury_cedula"],
date_of_birth: "1990-01-01",
personal_number: "1111111",
vendor_data: "user-1234",
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "URY",
Services: didit.Some([]string{"ury_cedula"}),
DateOfBirth: didit.String("1990-01-01"),
PersonalNumber: didit.String("1111111"),
VendorData: didit.String("user-1234"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.time.LocalDate;
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("URY")
.services(List.of("ury_cedula"))
.dateOfBirth(LocalDate.parse("1990-01-01"))
.personalNumber("1111111")
.vendorData("user-1234")
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'URY',
'services' => ['ury_cedula'],
'date_of_birth' => '1990-01-01',
'personal_number' => '1111111',
'vendor_data' => 'user-1234',
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "URY",
services: ["ury_cedula"],
date_of_birth: "1990-01-01",
personal_number: "1111111",
vendor_data: "user-1234"
)
puts result.to_h
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 = "URY",
Services = new string[] { "ury_cedula" },
DateOfBirth = "1990-01-01",
PersonalNumber = "1111111",
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
Toda llamada exitosa devuelve HTTP 200. El campo outcome_code te indica qué ocurrió realmente; distingue, 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; las acciones de coincidencia parcial o sin coincidencia que hayas configurado pueden sustituirlo.MATCH: el registro confirmó la identidad y todos los campos comprobados coincidieron.{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "URY",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "ury_cedula",
"service_name": "Uruguay - CI verification",
"source_data": {
"date_of_birth": "1990-01-01",
"first_name": "John",
"full_name": "John Doe",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe"
},
"validation": {
"date_of_birth": "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.{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "URY",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_MATCH",
"service_id": "ury_cedula",
"service_name": "Uruguay - CI verification",
"source_data": {
"date_of_birth": "1990-01-01",
"first_name": "John",
"full_name": "John Doe",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe"
},
"validation": {
"date_of_birth": "no_match",
"identification_number": "full_match"
}
}
]
}
NO_MATCH: el registro no devolvió ninguna coincidencia para los datos enviados.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "URY",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "ury_cedula",
"service_name": "Uruguay - CI verification",
"source_data": {
"date_of_birth": "NO_MATCH",
"identification_number": "NO_MATCH"
},
"validation": {
"date_of_birth": "no_match",
"identification_number": "no_match"
}
}
]
}
Datos devueltos
Los campos exactos que aparecen ensource_data dependen de lo que devuelva el registro. El ejemplo generado para ury_cedula documenta actualmente esta estructura normalizada:
date_of_birthfirst_namefull_nameidentification_numberlast_name
Precios y SLA
Las consultas de verificación de CI de Uruguay 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 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