Developer Reference
Endpoints & Integración
Infraestructura B2B escalable. Proporcionamos una interfaz RESTful anonimizada para pruebas y producción de alta disponibilidad con datos SUNAT y RENIEC.
Protocolo de Seguridad
Utilizamos el estándar RFC 6750 Bearer Token. Autoriza tus llamadas así:
Authorization: Bearer TU_TOKEN_RIXIA
IMPORTANTE: Las consultas básicas consumen 2 unidades de peticiones mensuales.
Response Schema (DNI)
{
"success": true,
"source": "RIXIA_API_V1",
"result": {
"first_name": "NOMBRE EJEMPLO",
"first_last_name": "APELLIDO1",
"second_last_name": "APELLIDO2",
"full_name": "APELLIDO1 APELLIDO2 NOMBRE EJEMPLO",
"document_type": "1",
"document_number": "00000000",
"birth_date": "Data in credit",
"gender": "F",
"nationality": "PER",
"address": "Data in credit",
"district": "Data in credit",
"province": "Data in credit",
"department": "Data in credit",
"phone": "Data in credit",
"email": "Data in credit"
}
}
Nota Técnica
Los campos marcados como "Data in credit" requieren el consumo de saldo premium para ser revelados. Costo: 2 Peticiones.
Response Schema (RUC)
{
"success": true,
"source": "RIXIA_API_V1",
"result": {
"razon_social": "EMPRESA EJEMPLO S.A.C.",
"tipo_documento": "6",
"numero_documento": "20000000000",
"estado": "ACTIVO",
"condicion": "HABIDO",
"direccion": "AV. EJEMPLO NRO 123 URB. EJEMPLO",
"ubigeo": "000000",
"via_tipo": "AV.",
"via_nombre": "EJEMPLO",
"zona_codigo": "URB.",
"zona_tipo": "EJEMPLO",
"numero": "123",
"interior": "-",
"lote": "-",
"dpto": "-",
"manzana": "-",
"kilometro": "-",
"distrito": "DISTRITO EJEMPLO",
"provincia": "PROVINCIA EJEMPLO",
"departamento": "DEPARTAMENTO EJEMPLO",
"es_agente_retencion": false,
"es_buen_contribuyente": true,
"locales_anexos": null,
"tipo": "SOCIEDAD ANONIMA CERRADA",
"actividad_economica": "ACTIVIDAD COMERCIAL EJEMPLO",
"numero_trabajadores": "1",
"tipo_facturacion": "MANUAL",
"tipo_contabilidad": "MANUAL",
"comercio_exterior": "SIN ACTIVIDAD"
}
}
Especificaciones
Consulta completa del Registro Único de Contribuyentes. Este módulo refleja fielmente la data tributaria oficial. Costo: 2 Peticiones.
Esquema de Respuesta Completo
{
"success": true,
"source": "RIXIA_API_V1",
"data": {
"images": [
{
"data_uri": "data:image/jpeg;base64,<BASE64_IMAGE_DATA>"
}
],
"dni": {
"numero": "00000000",
"digito_verificador": "0",
"completo": "00000000 - 0"
},
"nombres": "NOMBRE EJEMPLO",
"apellidos": "APELLIDO EJEMPLO",
"genero": "FEMENINO",
"nacimiento": {
"fecha": "01/01/2000",
"edad": "25 AÑOS",
"departamento": "LIMA",
"provincia": "LIMA",
"distrito": "MIRAFLORES"
},
"informacion_general": {
"nivel_educativo": "SUPERIOR COMPLETA",
"estado_civil": "SOLTERO",
"estatura": "1.70 MT.",
"fecha_inscripcion": "01/01/2015",
"fecha_emision": "01/01/2024",
"fecha_caducidad": "01/01/2030",
"donante_organos": "NO",
"padre": "NOMBRE PADRE",
"madre": "NOMBRE MADRE",
"restriccion": "NINGUNA"
},
"domicilio": {
"departamento": "LIMA",
"provincia": "LIMA",
"distrito": "MIRAFLORES",
"direccion": "AV. EJEMPLO 123"
},
"ubigeos": {
"reniec": "000000",
"ine": "00000",
"sunat": "00000"
}
}
}
Endpoint Técnico
GET /v1/dni?dni={numero}
Consulta integral de identidad con 1 imagen en base64. Costo: 7 Créditos.
Esquema de Respuesta Completo
{
"success": true,
"source": "RIXIA_API_V1",
"data": {
"images": [
{ "data_uri": "data:image/jpeg;base64,<BASE64_IMAGE_1>" },
{ "data_uri": "data:image/jpeg;base64,<BASE64_IMAGE_2>" },
{ "data_uri": "data:image/jpeg;base64,<BASE64_IMAGE_3>" },
{ "data_uri": "data:image/jpeg;base64,<BASE64_IMAGE_4>" }
],
"dni": {
"numero": "00000000",
"digito_verificador": "0",
"completo": "00000000 - 0"
},
"nombres": "NOMBRE EJEMPLO",
"apellidos": "APELLIDO EJEMPLO",
"genero": "FEMENINO",
"nacimiento": {
"fecha": "01/01/2000",
"edad": "25 AÑOS",
"departamento": "LIMA",
"provincia": "LIMA",
"distrito": "MIRAFLORES"
},
"informacion_general": {
"nivel_educativo": "SUPERIOR COMPLETA",
"estado_civil": "SOLTERO",
"estatura": "1.70 MT.",
"fecha_inscripcion": "01/01/2015",
"fecha_emision": "01/01/2024",
"fecha_caducidad": "01/01/2030",
"donante_organos": "NO",
"padre": "NOMBRE PADRE",
"madre": "NOMBRE MADRE",
"restriccion": "NINGUNA"
},
"domicilio": {
"departamento": "LIMA",
"provincia": "LIMA",
"distrito": "MIRAFLORES",
"direccion": "AV. EJEMPLO 123"
},
"ubigeos": {
"reniec": "000000",
"ine": "00000",
"sunat": "000000"
}
}
}
Endpoint Técnico
GET /v1/dnit?dni={numero}
Consulta con múltiples imágenes de ficha técnica RENIEC. Costo: 10 Créditos.
Esquema de Respuesta Completo
{
"success": true,
"source": "RIXIA_API_V1",
"data": {
"lineas_encontradas": 4,
"lineas": [
{
"telefono": "900000001",
"operador": "CLARO",
"periodo": "202605",
"empresa": "AMERICA MOVIL PERU S.A.C."
},
{
"telefono": "900000002",
"operador": "MOVISTAR",
"periodo": "202307",
"empresa": "TELEFONICA DEL PERU S.A.A."
},
{
"telefono": "900000003",
"operador": "ENTEL",
"periodo": "202210",
"empresa": "ENTEL PERU S.A."
},
{
"telefono": "900000004",
"operador": "BITEL",
"periodo": "202111",
"empresa": "VIETTEL PERU S.A.C."
}
]
}
}
Endpoint Técnico
GET /v1/telp?dni={numero}
Búsqueda de líneas activas asociadas a un documento de identidad. Costo: 20 Créditos.
Esquema de Respuesta Completo
{
"success": true,
"source": "RIXIA_API_V1",
"data": {
"titulares_encontrados": 1,
"titulares": [
{
"titular": "USUARIO DEMO",
"operador": "CLARO",
"telefono": "900000001",
"dni_ruc": "00000000",
"periodo": null,
"plan": "PlanDemo69_90",
"n_ip": null,
"correo": "usuario.demo@example.com",
"empresa": "AMERICA MOVIL PERU S.A.C."
}
]
}
}
Endpoint Técnico
GET /v1/telp-cel?numero={numero}
Búsqueda inversa: Identifica al titular y su plan a partir de un número móvil. Costo: 20 Créditos.
Esquema de Respuesta Completo
{
"success": true,
"source": "RIXIA_API_V1",
"data": {
"consulta": "00000000",
"familiares": 6,
"relaciones": [
{
"dni": "00000001",
"edad": 45,
"nombres": "NOMBRE EJEMPLO 1",
"apellidos": "APELLIDO DEMO",
"sexo": "MASCULINO",
"relacion": "PADRE",
"verificacion": "ALTO"
},
{
"dni": "00000002",
"edad": 42,
"nombres": "NOMBRE EJEMPLO 2",
"apellidos": "APELLIDO DEMO",
"sexo": "FEMENINO",
"relacion": "MADRE",
"verificacion": "ALTO"
},
{
"dni": "00000003",
"edad": 20,
"nombres": "NOMBRE EJEMPLO 3",
"apellidos": "APELLIDO DEMO",
"sexo": "FEMENINO",
"relacion": "PRIMA MATERNO",
"verificacion": "MEDIO"
},
{
"dni": "00000004",
"edad": 18,
"nombres": "NOMBRE EJEMPLO 4",
"apellidos": "APELLIDO DEMO",
"sexo": "MASCULINO",
"relacion": "PRIMO PATERNO",
"verificacion": "ALTO"
},
{
"dni": "00000005",
"edad": 35,
"nombres": "NOMBRE EJEMPLO 5",
"apellidos": "APELLIDO DEMO",
"sexo": "MASCULINO",
"relacion": "TIO MATERNO",
"verificacion": "ALTO"
},
{
"dni": "00000006",
"edad": 16,
"nombres": "NOMBRE EJEMPLO 6",
"apellidos": "APELLIDO DEMO",
"sexo": "FEMENINO",
"relacion": "HERMANASTRO",
"verificacion": "MEDIO"
}
]
}
}
Endpoint Técnico
GET /v1/ag?dni={numero}
Mapeo completo de parentesco directo y extendido. Costo: 13 Créditos.