Consulta por RUC

Retorna los datos fiscales de una empresa o persona natural registrada en SUNAT a partir de su número de RUC.

GEThttps://api.facturalo.pe/api/v3/consulta/ruc/{ruc}

Query

Campo

Descripción

ruc

stringrequerido

Número de RUC (11 dígitos).Ej: 20552103816

Campo	Descripción
numero	Número de RUC
nombre_o_razon_social	Nombre o razón social
tipo_contribuyente	Tipo de contribuyente (persona natural, SAC, SAA, etc.)
estado	Estado actual ante SUNAT (ACTIVO, SUSPENSION TEMPORAL, etc.)
condicion	Condición de domicilio (HABIDO, NO HABIDO, etc.)
departamento / provincia / distrito	Ubigeo en texto legible
direccion	Dirección fiscal registrada en SUNAT
direccion_completa	Dirección con ubigeo concatenado
ubigeo_sunat	Código ubigeo SUNAT (6 dígitos)
ubigeo	Array [departamento, provincia, distrito] como códigos

Language

Credentials

Header

Authorization

Ejemplos con el SDK oficial en Node, PHP y Python

API Request

$ npm install @facturalo-pe/node

import { FacturaloClient } from "@facturalo-pe/node";

const facturalo = new FacturaloClient({ token: process.env.FACTURALO_TOKEN! });

const result = await facturalo.consultas.ruc("20552103816");
console.log(result);

SDK oficial @facturalo-pe/node · guía en /sdks

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "data": {
    "numero": "20552103816",
    "nombre_o_razon_social": "AGROLIGHT PERU S.A.C.",
    "tipo_contribuyente": "SOCIEDAD ANONIMA CERRADA",
    "estado": "SUSPENSION TEMPORAL",
    "condicion": "HABIDO",
    "departamento": "LIMA",
    "provincia": "LIMA",
    "distrito": "SANTA ANITA",
    "direccion": "PJ. JORGE BASADRE NRO. 158 URB. POP LA UNIVERSAL 2DA ET.",
    "direccion_completa": "PJ. JORGE BASADRE NRO. 158 URB. POP LA UNIVERSAL 2DA ET., LIMA - LIMA - SANTA ANITA",
    "ubigeo_sunat": "150137",
    "ubigeo": [
      "15",
      "1501",
      "150137"
    ]
  }
}