endpoint.pe

Consulta por razón social

Busca empresas por su nombre o razón social en el padrón de SUNAT y obtén el RUC, el estado y la condición de cada coincidencia.

GEThttps://api.endpoint.pe/v1/empresas?q={texto}
Fuente:
SUNAT
Costo:
1 crédito por consulta con resultado
Estado:
Disponible
Probar en el playground Página de la API

Busca en el padrón de SUNAT por las palabras del nombre o razón social y devuelve hasta 20 coincidencias, cada una con su RUC, estado, condición y ubigeo. Sirve cuando tu cliente no tiene el RUC a la mano o para ofrecer un autocompletado de empresas. Con el RUC de la coincidencia correcta, pide la ficha completa en Consulta RUC.

Parámetros

NombreDóndeFormato
qQuery stringTexto de 3 a 80 caracteres. Codifícalo en la URL (los espacios como %20 o +).

Ejemplo

terminal
curl 'https://api.endpoint.pe/v1/empresas?q=superintendencia aduanas' \  -H 'Authorization: Bearer TU_TOKEN'
respuesta.json
{  "success": true,  "message": "Consulta exitosa",  "data": {    "consulta": "superintendencia aduanas",    "modo": "texto",    "cantidad": 1,    "resultados": [      {        "ruc": "20131312955",        "razon_social": "SUPERINTENDENCIA NACIONAL DE ADUANAS Y DE ADMINISTRACION TRIBUTARIA - SUNAT",        "estado": "ACTIVO",        "condicion": "HABIDO",        "ubigeo": "150101"      }    ]  },  "meta": {    "fuente": "SUNAT",    "consultado_en": "2026-10-12T07:40:12Z",    "creditos_cobrados": 1,    "creditos_disponibles": 14621  }}

Campos de data

CampoDescripción
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.

Cómo busca

  • Por palabras: cada palabra del texto debe aparecer al inicio de alguna palabra del nombre. super encuentra "SUPERINTENDENCIA"; banco credito encuentra los nombres que contienen una palabra que empieza por "BANCO" y otra que empieza por "CREDITO". No importan las mayúsculas.
  • Las palabras de menos de 3 caracteres se ignoran (de, y, SA). Escribir banco de credito equivale a banco credito.
  • Los resultados llegan ordenados por relevancia y luego por nombre, hasta 20. Si hay más coincidencias, afina el texto con otra palabra.
  • modo indica cómo se buscó: texto (por palabras) es el modo normal; prefijo (por inicio exacto del nombre) solo aparece si la búsqueda por palabras no estuviera disponible.

Guía: Buscar RUC por razón social.

Errores

HTTPerrorCuándo
404no_encontradoNinguna empresa coincide con el texto. No descuenta créditos.
422validaciondetalles.q: "Escribe entre 3 y 80 caracteres."

Los demás códigos (401, 402, 403, 502) son comunes a todas las APIs: Errores.

Relacionados