Documentación de la API

Introducción

VerificaRD expone una API REST para consultar datos de identidad a partir del número de cédula. Está pensada para integraciones servidor-a-servidor: tu backend (PHP, Node, Python, Java, etc.) llama a la API con una clave secreta, sin necesidad de un login interactivo.

URL base: https://api.verifica-rd.com

Autenticación

Cada petición se autentica con tu API Key en el encabezado X-Api-Key. Genera y revoca tus claves desde tu panel. La clave se muestra una sola vez al crearla; guárdala de forma segura.

Encabezado

X-Api-Key: jce_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Consultar una cédula

POST /api/v1/cedula-queries/query

Consume 1 token. Si la cédula no existe, el token se reembolsa automáticamente.

Solicitud

curl

curl -X POST https://api.verifica-rd.com/api/v1/cedula-queries/query \
  -H "X-Api-Key: jce_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "cedula": "00100000000" }'

Respuesta 200 OK

JSON

{
  "success": true,
  "data": {
    "cedula": "00100000000",
    "result": {
      "nombres": "JUAN",
      "apellido1": "PÉREZ RODRÍGUEZ",
      "nombreCompleto": "JUAN PÉREZ RODRÍGUEZ",
      "fechaNacimiento": "1990-05-15",
      "lugarNacimiento": "SANTO DOMINGO, R.D.",
      "sexo": "M",
      "nacionalidad": "REPÚBLICA DOMINICANA"
    },
    "cost": 1,
    "status": "COMPLETED"
  }
}

Ejemplo en PHP

consulta.php

$ch = curl_init('https://api.verifica-rd.com/api/v1/cedula-queries/query');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    'X-Api-Key: jce_live_xxxxxxxxxxxxxxxxxxxx',
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode(['cedula' => '00100000000']),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

Historial de consultas

GET /api/v1/cedula-queries/history?page=0&size=10

Devuelve tus consultas paginadas, de la más reciente a la más antigua.

Manejo de errores

401 / 403 — API Key ausente, inválida o revocada.
402 — Sin tokens suficientes para la consulta.
404 — La cédula no existe en el registro (token reembolsado).
400 — Formato de cédula inválido.

Tokens y precios

El modelo es de pago por consulta: 1 token = 1 consulta, a un precio de US$1.00 por consulta. Compras la cantidad de tokens que necesites desde tu panel, sin mensualidades.

Crear cuenta y obtener una API Key

API de VerificaRD