Endpoint RUC

Consulta información oficial de contribuyentes registrados en SUNAT a partir del número de RUC.

URL

GET /api/ruc?numero=20XXXXXXXXX

Parámetros

Parámetro Tipo Descripción
numero string (requerido) 11 dígitos numéricos.
proveedor string (opcional) sunat-scraper, apiperu.dev, apis.net.pe.

Ejemplo de request

curl -X GET "https://apisperu.gsalinas.site/api/ruc?numero=20100047218" \
  -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",
    "direccion": "CAL. CENTENARIO NRO. 156 URB. LAS LADERAS DE MELGAREJO",
    "ubigeo": "150114",
    "departamento": "LIMA",
    "provincia": "LIMA",
    "distrito": "LA MOLINA",
    "tipo": "SOCIEDAD ANONIMA"
  },
  "proveedor": "sunat-scraper"
}

Campos del response

Campo Tipo Descripción
numero string RUC consultado (11 dígitos).
razonSocial string Razón social registrada en SUNAT.
estado string Estado del contribuyente (ACTIVO, BAJA, SUSPENDIDO).
condicion string Condición de domicilio (HABIDO, NO HABIDO).
direccion string Domicilio fiscal completo.
ubigeo string Código de ubigeo de 6 dígitos.
departamento string Departamento del domicilio.
provincia string Provincia del domicilio.
distrito string Distrito del domicilio.
tipo string Tipo de contribuyente (SOCIEDAD ANONIMA, etc.).

Errores específicos

Probar en el playground