Buscador de proveedores y clientes
Un campo de búsqueda por nombre que devuelve RUC, estado y condición para elegir la empresa correcta.
Empresas · Fuente: SUNAT
API de consulta por razón social
Escribe el nombre o la razón social de una empresa y recibe su RUC, estado y condición. Útil cuando tu cliente no tiene el RUC a la mano.
Cómo consultarla
Haz una petición GET con tu token en la cabecera Authorization y recibe la respuesta en JSON. Elige tu lenguaje, copia el código y reemplaza TU_TOKEN por el de tu cuenta.
GET https://api.endpoint.pe/v1/empresas?q=superintendencia aduanasObtener mi token gratisrespuesta.json
Qué datos devuelve
Fuente oficial: SUNAT. Cada respuesta trae siempre los mismos campos, en JSON.
consultaTexto buscado.
modotexto (por palabras) o prefijo (por inicio del nombre).
cantidadResultados devueltos (máximo 20).
resultadosLista de empresas con ruc, razon_social, estado, condicion y ubigeo.
Qué es la búsqueda por razón social y para qué sirve
Muchas veces el cliente o el proveedor no tiene el RUC a la mano, pero sí sabe cómo se llama la empresa. La búsqueda por razón social resuelve justo eso: envías el nombre, completo o en parte, y recibes las empresas que coinciden con su RUC, estado, condición y ubigeo.
La API busca por palabras dentro de la razón social registrada en SUNAT y ordena los resultados por relevancia, con un máximo de 20 coincidencias por consulta. Las palabras de menos de tres letras se ignoran. Con el RUC de cada resultado puedes pedir la ficha completa a la API de consulta RUC.
Para qué se usa la API de consulta por razón social
Completar el RUC que falta
Cuando solo tienes el nombre de la empresa en un registro antiguo, recupera su RUC para normalizar tu base de datos.
Detectar duplicados
Antes de crear un nuevo cliente, comprueba si ya existe una empresa con ese nombre y qué RUC tiene.
Preguntas frecuentes
Preguntas sobre la API de consulta por razón social
Si tu duda no está aquí, escríbenos y te responde una persona del equipo.
Our Blog
Guías relacionadas en el blog
Cómo funcionan estos datos en el Perú y cómo integrarlos en tu sistema.
SUNAT
Cómo buscar un RUC por razón social o nombre de empresa
Tu cliente no tiene el RUC a la mano, pero sí el nombre. Aprende a buscar RUC por razón social, resolver homónimos y armar un buscador en tu sistema.
Equipo endpoint.pe•21 abr. 2026
Facturación
Checklist para validar un cliente antes de facturar
Validar cliente antes de facturar: RUC válido, ACTIVO y HABIDO, razón social, dirección, tipo de comprobante, moneda y tipo de cambio. Cómo automatizarlo.
Equipo endpoint.pe•20 jun. 2026
SUNAT
Qué es el RUC y cómo está compuesto: los 11 dígitos explicados
El RUC es el número con el que SUNAT identifica a cada contribuyente. Te explicamos qué es el RUC, qué significan sus 11 dígitos y qué datos públicos revela.
Equipo endpoint.pe•02 mar. 2026
Integración
Cómo elegir una API de consulta RUC y DNI en Perú (guía 2026)
Criterios para elegir una API de consulta RUC y DNI en Perú: fuentes oficiales, precio por crédito, plan gratis, documentación y soporte. Con tabla de evaluación.
Equipo endpoint.pe•10 oct. 2026Deja de copiar datos a mano.
Automatízalo hoy mismo
Crea tu cuenta, copia tu token y empieza hoy con 150 consultas gratis al mes.