Búsqueda por nombre

Encuentra empresas a partir de su razón social, incluso si no conoces el número exacto de RUC.

URL

GET /api/nombre?q=BANCO+CREDITO

Parámetros

Parámetro Tipo Descripción
q string (requerido) Razón social a buscar. Mínimo 3 caracteres.

Ejemplo de request

curl -X GET "https://apisperu.gsalinas.site/api/nombre?q=BANCO+CREDITO" \
  -H "Authorization: Bearer apk_demo_apisperu_pub_2BfHK7nN4tV9X8jE3LpQ5sUcZ"

Ejemplo de response

{
  "ok": true,
  "data": [
    {
      "numero": "20100047218",
      "razonSocial": "BANCO DE CREDITO DEL PERU",
      "estado": "ACTIVO",
      "condicion": "HABIDO"
    },
    {
      "numero": "20330401991",
      "razonSocial": "BANCO DE CREDITO DEL PERU - SUCURSAL PANAMA",
      "estado": "ACTIVO",
      "condicion": "HABIDO"
    }
  ],
  "total": 2
}

Campos del response

El campo data es un array de coincidencias. Cada elemento incluye:

Campo Tipo Descripción
numero string Número de RUC encontrado.
razonSocial string Razón social completa de la empresa.
estado string Estado SUNAT (ACTIVO, BAJA, SUSPENDIDO).
condicion string Condición de domicilio (HABIDO, NO HABIDO).

Errores específicos

Probar en el playground