Copiado al portapapeles

Documentación APIs masitaprex Masitaprex

infraestructura tecnológica masitaprex APIs v3 funciona exclusivamente como intermediario de infraestructura tecnológica.

Probador de APIs

Selecciona un endpoint

Respuesta de la API

{}

Documentación de las APIs

POST Consulta RENIEC por DNI

Consulta datos completos del DNI incluyendo huellas, firma y nombres de padres

7 créditos
POST https://api.masitaprex.com/v3/consulta/dni

Esta API devuelve la información completa del registro civil de una persona peruana según RENIEC. Incluye datos biométricos como huellas dactilares digitalizadas, imagen de la firma, nombres completos de los padres, y toda la información contenida en el DNI físico.

Parámetros

Parámetro Tipo Requerido Descripción
dni String Sí Número de DNI de 8 dígitos

Ejemplos de Solicitud

curl -X POST \
  'https://api.masitaprex.com/v3/consulta/dni' \
  -H 'x-api-key: TU_TOKEN_AQUI' \
  -H 'Content-Type: application/json' \
  -d '{
    "dni": "12345678"
  }'
import requests

url = "https://api.masitaprex.com/v3/consulta/dni"
headers = {
    "x-api-key": "TU_TOKEN_AQUI",
    "Content-Type": "application/json"
}
data = {"dni": "12345678"}

response = requests.post(url, headers=headers, json=data)
print(response.json())
fetch('https://api.masitaprex.com/v3/consulta/dni', {
    method: 'POST',
    headers: {
        'x-api-key': 'TU_TOKEN_AQUI',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        dni: '12345678'
    })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
 '12345678');
$headers = array(
    'x-api-key: TU_TOKEN_AQUI',
    'Content-Type: application/json'
);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

Ejemplo de Respuesta

{
  "success": true,
  "data": {
    "dni": "12345678",
    "nombres": "JUAN CARLOS",
    "apellido_paterno": "PEREZ",
    "apellido_materno": "GOMEZ",
    "fecha_nacimiento": "1990-01-01",
    "sexo": "MASCULINO",
    "estado_civil": "SOLTERO",
    "ubigeo_nacimiento": "150101",
    "direccion": "AV. SIEMPRE VIVA 123",
    "departamento": "LIMA",
    "provincia": "LIMA",
    "distrito": "LIMA",
    "nombres_padre": "CARLOS PEREZ",
    "apellidos_padre": "RODRIGUEZ",
    "nombres_madre": "MARIA GOMEZ",
    "apellidos_madre": "LOPEZ",
    "huella_derecha": "BASE64_IMAGE_DATA",
    "huella_izquierda": "BASE64_IMAGE_DATA",
    "firma_digitalizada": "BASE64_IMAGE_DATA",
    "foto": "BASE64_IMAGE_DATA",
    "estatura": "175",
    "grupo_votacion": "A123",
    "fecha_emision": "2020-05-15",
    "fecha_caducidad": "2030-05-15"
  },
  "meta": {
    "version": "3.0.0",
    "timestamp": "2024-04-15T10:30:00Z",
    "request_id": "req_abc123",
    "server": "cluster-aws-pe-secure-01"
  },
  "consulta-pe": {
    "poweredBy": "Intermediario Consulta Pe v2",
    "status": "Verified Source",
    "userPlan": {
      "tipo": "creditos",
      "creditosRestantes": 993
    }
  }
}

POST Telefonía por Documento

Consulta números telefónicos asociados a un DNI o RUC

9 créditos
POST https://api.masitaprex.com/v3/consulta/telefonia-doc

Obtiene los números de teléfono móvil y fijo asociados a un documento de identidad (DNI) o RUC. Incluye información del operador, tipo de línea, fecha de activación y estado actual.

Parámetros

Parámetro Tipo Requerido Descripción
documento String Sí DNI (8 dígitos) o RUC (11 dígitos)

Ejemplo de Solicitud

import requests

url = "https://api.masitaprex.com/v3/consulta/telefonia-doc"
headers = {"x-api-key": "TU_TOKEN", "Content-Type": "application/json"}
data = {"documento": "12345678"}

response = requests.post(url, headers=headers, json=data)
if response.status_code == 200:
    telefonos = response.json()
    for tel in telefonos['data']['lineas']:
        print(f"Número: {tel['numero']}, Operador: {tel['operador']}")

Ejemplo de Respuesta

{
  "success": true,
  "data": {
    "documento": "12345678",
    "titular": "JUAN CARLOS PEREZ GOMEZ",
    "lineas": [
      {
        "numero": "987654321",
        "operador": "CLARO",
        "tipo": "MOVIL",
        "estado": "ACTIVO",
        "fecha_activacion": "2020-03-15",
        "portabilidad": false
      },
      {
        "numero": "945123456",
        "operador": "MOVISTAR",
        "tipo": "MOVIL",
        "estado": "ACTIVO",
        "fecha_activacion": "2019-11-20",
        "portabilidad": true
      }
    ],
    "total_lineas": 2
  }
}

POST Telefonía por Número

Consulta titularidad de un número telefónico específico

8 créditos
POST https://api.masitaprex.com/v3/consulta/telefonia-num

Permite verificar la titularidad de un número telefónico específico. Devuelve información del propietario, tipo de línea, operador y estado de la línea.

Parámetros

Parámetro Tipo Requerido Descripción
numero String Sí Número telefónico de 9 dígitos

Ejemplo de Solicitud

curl -X POST \
  'https://api.masitaprex.com/v3/consulta/telefonia-num' \
  -H 'x-api-key: TU_TOKEN_AQUI' \
  -H 'Content-Type: application/json' \
  -d '{"numero": "987654321"}'

Ejemplo de Respuesta

{
  "success": true,
  "data": {
    "numero": "987654321",
    "titular": "JUAN CARLOS PEREZ GOMEZ",
    "documento": "12345678",
    "operador": "CLARO",
    "tipo": "MOVIL",
    "estado": "ACTIVO",
    "fecha_activacion": "2020-03-15",
    "portabilidad": false,
    "departamento": "LIMA"
  }
}

POST Datos SUNARP Vehículo

Consulta información de vehículos y propietarios

8 créditos
POST https://api.masitaprex.com/v3/consulta/placa

Consulta la información registral de vehículos en SUNARP. Incluye datos del propietario, características del vehículo, historial de transferencias y restricciones si las hubiera.

Parámetros

Parámetro Tipo Requerido Descripción
placa String Sí Placa del vehículo (ej: ABC-123)

Ejemplo de Solicitud

fetch('https://api.masitaprex.com/v3/consulta/placa', {
    method: 'POST',
    headers: {
        'x-api-key': 'TU_TOKEN_AQUI',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({ placa: 'ABC-123' })
})
.then(response => response.json())
.then(data => console.log(data));

Ejemplo de Respuesta

{
  "success": true,
  "data": {
    "placa": "ABC-123",
    "propietario": {
      "nombre": "JUAN CARLOS PEREZ GOMEZ",
      "documento": "12345678",
      "tipo_documento": "DNI"
    },
    "vehiculo": {
      "marca": "TOYOTA",
      "modelo": "COROLLA",
      "año": "2020",
      "color": "GRIS",
      "clase": "AUTOMOVIL",
      "carroceria": "SEDAN",
      "combustible": "GASOLINA",
      "motor": "1ZR1234567",
      "serie": "JTDBT123456789",
      "asientos": 5,
      "cilindros": 4,
      "cilindrada": "1800"
    },
    "estado": "ACTIVO",
    "gravamenes": [],
    "anotaciones": []
  }
}

POST SUNAT por RUC

Consulta datos fiscales de empresas por RUC

6 créditos
POST https://api.masitaprex.com/v3/consulta/ruc

Obtiene información fiscal completa de empresas registradas en SUNAT. Incluye razón social, dirección, estado, condición (habido/no habido), actividad económica y representantes legales.

Parámetros

Parámetro Tipo Requerido Descripción
data String Sí Número de RUC (11 dígitos)

Ejemplo de Solicitud

 '20123456789');
$headers = array(
    'x-api-key: TU_TOKEN_AQUI',
    'Content-Type: application/json'
);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

Ejemplo de Respuesta

{
  "success": true,
  "data": {
    "ruc": "20123456789",
    "razon_social": "EMPRESA EJEMPLO S.A.C.",
    "estado": "ACTIVO",
    "condicion": "HABIDO",
    "direccion": "AV. EJEMPLO 123 - LIMA - LIMA - SAN ISIDRO",
    "departamento": "LIMA",
    "provincia": "LIMA",
    "distrito": "SAN ISIDRO",
    "ubigeo": "150131",
    "tipo_contribuyente": "SOCIEDAD ANONIMA CERRADA",
    "fecha_inscripcion": "2015-03-20",
    "sistema_emision": "MANUAL/COMPUTARIZADO",
    "actividad_comercial": "COMERCIO AL POR MENOR",
    "num_trabajadores": "5 A 10",
    "tipo_facturacion": "FACTURA FISICA Y ELECTRONICA",
    "representante_legal": "JUAN CARLOS PEREZ GOMEZ"
  }
}

POST Empresas Relacionadas

Consulta empresas donde figura una persona

4 créditos
POST https://api.masitaprex.com/v3/consulta/empresas

Lista todas las empresas donde una persona figura como representante legal, socio, accionista o trabajador. Incluye porcentaje de participación y cargo.

Parámetros

Parámetro Tipo Requerido Descripción
dni String Sí Número de DNI de 8 dígitos

Ejemplo de Solicitud

curl -X POST \
  'https://api.masitaprex.com/v3/consulta/empresas' \
  -H 'x-api-key: TU_TOKEN_AQUI' \
  -H 'Content-Type: application/json' \
  -d '{"dni": "12345678"}'

Ejemplo de Respuesta

{
  "success": true,
  "data": {
    "dni": "12345678",
    "persona": "JUAN CARLOS PEREZ GOMEZ",
    "empresas": [
      {
        "ruc": "20123456789",
        "razon_social": "EMPRESA EJEMPLO S.A.C.",
        "cargo": "GERENTE GENERAL",
        "participacion": "45%",
        "fecha_nombramiento": "2015-03-20",
        "estado": "ACTIVO"
      },
      {
        "ruc": "20987654321",
        "razon_social": "COMERCIAL EJEMPLO E.I.R.L.",
        "cargo": "REPRESENTANTE LEGAL",
        "participacion": "100%",
        "fecha_nombramiento": "2018-07-10",
        "estado": "ACTIVO"
      }
    ],
    "total": 2
  }
}

POST Matrimonios Registrados

Consulta registro de matrimonios civiles

6 créditos
POST https://api.masitaprex.com/v3/consulta/matrimonios

Consulta el registro de matrimonios civiles asociados a un DNI. Incluye información del cónyuge, fecha de matrimonio y lugar de registro.

Parámetros

Parámetro Tipo Requerido Descripción
dni String Sí Número de DNI de 8 dígitos

Ejemplo de Solicitud

fetch('https://api.masitaprex.com/v3/consulta/matrimonios', {
    method: 'POST',
    headers: {
        'x-api-key': 'TU_TOKEN_AQUI',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({ dni: '12345678' })
})
.then(response => response.json())
.then(data => console.log(data));

Ejemplo de Respuesta

{
  "success": true,
  "data": {
    "dni": "12345678",
    "persona": "JUAN CARLOS PEREZ GOMEZ",
    "matrimonios": [
      {
        "conyuge": {
          "nombres": "MARIA ISABEL",
          "apellidos": "RODRIGUEZ LOPEZ",
          "dni": "87654321"
        },
        "fecha_matrimonio": "2018-06-15",
        "lugar_registro": "MUNICIPALIDAD DE LIMA",
        "estado": "VIGENTE",
        "regimen_patrimonial": "SEPARACION DE PATRIMONIOS"
      }
    ],
    "total": 1
  }
}

POST Buscar DNI por Nombres

Encuentra DNI usando nombres y apellidos

5 créditos
POST https://api.masitaprex.com/v3/consulta/buscar-dni

Busca posibles números de DNI asociados a nombres y apellidos completos. Útil cuando se conoce el nombre pero no el documento.

Parámetros

Parámetro Tipo Requerido Descripción
nombres String Sí Nombres de la persona
apepaterno String Sí Apellido paterno
apematerno String No Apellido materno

Ejemplo de Solicitud

import requests

url = "https://api.masitaprex.com/v3/consulta/buscar-dni"
headers = {"x-api-key": "TU_TOKEN", "Content-Type": "application/json"}
data = {
    "nombres": "JUAN CARLOS",
    "apepaterno": "PEREZ",
    "apematerno": "GOMEZ"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Ejemplo de Respuesta

{
  "success": true,
  "data": {
    "busqueda": {
      "nombres": "JUAN CARLOS",
      "apellido_paterno": "PEREZ",
      "apellido_materno": "GOMEZ"
    },
    "resultados": [
      {
        "dni": "12345678",
        "nombres_completos": "JUAN CARLOS PEREZ GOMEZ",
        "fecha_nacimiento": "1990-01-01",
        "departamento": "LIMA",
        "exactitud": "100%"
      },
      {
        "dni": "23456789",
        "nombres_completos": "JUAN CARLOS PEREZ GOMEZ",
        "fecha_nacimiento": "1985-05-20",
        "departamento": "AREQUIPA",
        "exactitud": "100%"
      }
    ],
    "total": 2
  }
}

POST Buscar Venezolano por Nombre

Busca personas venezolanas por nombres

5 créditos
POST https://api.masitaprex.com/v3/consulta/buscar-cedula

Busca personas de nacionalidad venezolana utilizando sus nombres y apellidos. Devuelve posibles coincidencias con sus cédulas.

Parámetros

Parámetro Tipo Requerido Descripción
query String Sí Nombres y apellidos completos

Ejemplo de Solicitud

curl -X POST \
  'https://api.masitaprex.com/v3/consulta/buscar-cedula' \
  -H 'x-api-key: TU_TOKEN_AQUI' \
  -H 'Content-Type: application/json' \
  -d '{"query": "MARIA RODRIGUEZ"}'

Ejemplo de Respuesta

{
  "success": true,
  "data": {
    "busqueda": "MARIA RODRIGUEZ",
    "resultados": [
      {
        "cedula": "V12345678",
        "nombres_completos": "MARIA ISABEL RODRIGUEZ LOPEZ",
        "fecha_nacimiento": "1992-03-15",
        "sexo": "FEMENINO",
        "estado": "ACTIVO"
      },
      {
        "cedula": "V23456789",
        "nombres_completos": "MARIA RODRIGUEZ GONZALEZ",
        "fecha_nacimiento": "1988-11-20",
        "sexo": "FEMENINO",
        "estado": "ACTIVO"
      }
    ],
    "total": 2
  }
}

POST Consultar Cédula Venezolana

Consulta datos por cédula venezolana

5 créditos
POST https://api.masitaprex.com/v3/consulta/cedula

Consulta información de personas venezolanas utilizando su número de cédula de identidad. Incluye datos personales y de registro.

Parámetros

Parámetro Tipo Requerido Descripción
cedula String Sí Número de cédula (ej: V12345678)

Ejemplo de Solicitud

fetch('https://api.masitaprex.com/v3/consulta/cedula', {
    method: 'POST',
    headers: {
        'x-api-key': 'TU_TOKEN_AQUI',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({ cedula: 'V12345678' })
})
.then(response => response.json())
.then(data => console.log(data));

Ejemplo de Respuesta

{
  "success": true,
  "data": {
    "cedula": "V12345678",
    "nombres": "MARIA ISABEL",
    "apellidos": "RODRIGUEZ LOPEZ",
    "fecha_nacimiento": "1992-03-15",
    "sexo": "FEMENINO",
    "estado_civil": "SOLTERA",
    "lugar_nacimiento": "CARACAS",
    "direccion": "AVENIDA BOLIVAR SECTOR 5",
    "estado": "ACTIVO",
    "fecha_expedicion": "2010-05-20"
  }
}