Consultar RUC o DNI
GET /api/service/{service_type}/{service_number}
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Consulta los datos de un RUC o DNI en el servicio de consultas de la plataforma (padrón SUNAT / RENIEC). Con el servicio de consultas adicionales activo también admite carné de extranjería, placa y licencia de conducir. Cada consulta exitosa cuenta para el consumo del plan.
⚠️ Este endpoint usa GET por compatibilidad; próximamente tendrá una versión POST.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success.
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
service_type (ruta) |
string | Sí | ruc, dni; con consultas adicionales: ce, placa, licencia. |
service_number (ruta) |
string | Sí | Número a consultar (11 dígitos RUC, 8 DNI). |
Respuesta: para ruc, data = {name, trade_name, address, location_id: [dep, prov, dist], condition, state, is_agent_retention}; para dni, data = {name, trade_name, location_id, address, department_id, province_id, district_id, condition, state}. Puede incluir otras claves de primer nivel del proveedor (p. ej. source).
Errores (HTTP 200 con success: false): número no encontrado o inválido; El servicio de consulta de placa no está disponible. Active el servicio de consultas adicionales.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
service_type |
ruta | sí | ruc |
|
service_number |
ruta | sí | 20501973522 |
Respuestas
200 — RUC
{
"success": true,
"data": {
"name": "EMPRESA XYZ S.A.C.",
"trade_name": "",
"address": "AV. 2 DE MAYO NRO. 123 LIMA - LIMA - LIMA",
"location_id": [
"15",
"1501",
"150101"
],
"condition": "HABIDO",
"state": "ACTIVO",
"is_agent_retention": false
},
"source": "apiperu.dev"
}
200 — No disponible
{
"success": false,
"message": "El servicio de consulta de placa no está disponible. Active el servicio de consultas adicionales."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.