RUC

La información se actualiza en nuestra base de datos diariamente con información oficial según disponibilidad del padrón reducido publicado por SUNAT.

Consulta RUC

GEThttps://api.migo.pe/api/v2/ruc/{ruc}

Authorization

bearerAuth

Path parameters

ruc*string

Example: "20603274742"

Response

200403404

OK

Body

application/json

successboolean

rucstring

nombre_o_razon_socialstring

estado_del_contribuyentestring

condicion_de_domiciliostring

ubigeostring

tipo_de_viastring

nombre_de_viastring

codigo_de_zonastring

tipo_de_zonastring

numerostring

interiorstring

lotestring

dptostring

manzanastring

kilometrostring

distritostring

provinciastring

departamentostring

direccion_simplestring

direccionstring

actualizado_enstring

Request

JavaScriptCurlPython

const response = await fetch('https://api.migo.pe/api/v2/ruc/{ruc}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Response

200

{
  "success": true,
  "ruc": "20603274742",
  "nombre_o_razon_social": "MIGO SOCIEDAD ANONIMA CERRADA - MIGO S.A.C.",
  "estado_del_contribuyente": "ACTIVO",
  "condicion_de_domicilio": "HABIDO",
  "ubigeo": "040112",
  "tipo_de_via": "AV.",
  "nombre_de_via": "JORGE CHAVEZ",
  "codigo_de_zona": "URB.",
  "tipo_de_zona": "JORGE CHAVEZ",
  "numero": "204",
  "interior": "-",
  "lote": "-",
  "dpto": "-",
  "manzana": "-",
  "kilometro": "-",
  "distrito": "PAUCARPATA",
  "provincia": "AREQUIPA",
  "departamento": "AREQUIPA",
  "direccion_simple": "AV. JORGE CHAVEZ NRO. 204 URB. JORGE CHAVEZ",
  "direccion": "AV. JORGE CHAVEZ NRO. 204 URB. JORGE CHAVEZ - AREQUIPA AREQUIPA PAUCARPATA",
  "actualizado_en": "2024-01-01 20:00:00"
}

Consulta RUC con actividades económicas

GEThttps://api.migo.pe/api/v2/ruc-actividad/{ruc}

Authorization

bearerAuth

Path parameters

ruc*string

Example: "20603274742"

Response

200403404

OK

Body

application/json

successboolean

rucstring

nombre_o_razon_socialstring

estado_del_contribuyentestring

condicion_de_domiciliostring

ubigeostring

tipo_de_viastring

nombre_de_viastring

codigo_de_zonastring

tipo_de_zonastring

numerostring

interiorstring

lotestring

dptostring

manzanastring

kilometrostring

distritostring

provinciastring

departamentostring

direccion_simplestring

direccionstring

actualizado_enstring

informacion_adicionalActivity (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.migo.pe/api/v2/ruc-actividad/{ruc}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Response

200

{
  "success": true,
  "ruc": "20603274742",
  "nombre_o_razon_social": "MIGO SOCIEDAD ANONIMA CERRADA - MIGO S.A.C.",
  "estado_del_contribuyente": "ACTIVO",
  "condicion_de_domicilio": "HABIDO",
  "ubigeo": "040112",
  "tipo_de_via": "AV.",
  "nombre_de_via": "JORGE CHAVEZ",
  "codigo_de_zona": "URB.",
  "tipo_de_zona": "JORGE CHAVEZ",
  "numero": "204",
  "interior": "-",
  "lote": "-",
  "dpto": "-",
  "manzana": "-",
  "kilometro": "-",
  "distrito": "PAUCARPATA",
  "provincia": "AREQUIPA",
  "departamento": "AREQUIPA",
  "direccion_simple": "AV. JORGE CHAVEZ NRO. 204 URB. JORGE CHAVEZ",
  "direccion": "AV. JORGE CHAVEZ NRO. 204 URB. JORGE CHAVEZ - AREQUIPA AREQUIPA PAUCARPATA",
  "actualizado_en": "2024-01-01 20:00:00",
  "informacion_adicional": {
    "tipo": "SOCIEDAD ANONIMA CERRADA",
    "actividad_economica_rev3_principal": "CONSULTORES PROGRAMAS Y SUMINISTROS INFORMATICOS",
    "actividad_economica_rev3_secundaria": "VENTA AL POR MAYOR DE MAQUINARIA EQUIPO Y MATERIALES",
    "actividad_economica_rev4_principal": "CONSULTORIA DE INFORMATICA Y GESTION DE INSTALACIONES INFORMATICAS",
    "numero_trabajadores": "7",
    "tipo_facturacion": "MANUAL/COMPUTARIZADO",
    "tipo_contabilidad": "COMPUTARIZADO",
    "comercio_exterior": "SIN ACTIVIDAD",
    "periodo_publicacion": "202408"
  }
}

Consulta RUC desde SUNAT

La consulta RUC se hace en tiempo real desde los servidores SUNAT. Puede presentar mayor latencia y/o errores de conexión.

GEThttps://api.migo.pe/api/v2/ruc-sunat/{ruc}

Authorization

bearerAuth

Path parameters

ruc*string

Example: "20131380951"

Response

200403404

OK

Body

application/json

successboolean

rucstring

nombre_o_razon_socialstring

estado_del_contribuyentestring

condicion_de_domiciliostring

departamentostring

provinciastring

distritostring

direccionstring

Request

JavaScriptCurlPython

const response = await fetch('https://api.migo.pe/api/v2/ruc-sunat/{ruc}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Response

200

{
  "success": true,
  "ruc": "20603274742",
  "nombre_o_razon_social": "MIGO SOCIEDAD ANONIMA CERRADA - MIGO S.A.C.",
  "estado_del_contribuyente": "ACTIVO",
  "condicion_de_domicilio": "HABIDO",
  "departamento": "AREQUIPA",
  "provincia": "AREQUIPA",
  "distrito": "PAUCARPATA",
  "direccion": "AV. JORGE CHAVEZ NRO. 204 URB.  JORGE CHAVEZ"
}

Recomendamos usar este endpoint como método alternativo solo si detecta que las consultas RUC no devuelven datos actualizados desde nuestra base de datos.

Consulta representantes legales desde SUNAT

La consulta RUC se hace en tiempo real desde los servidores SUNAT. Puede presentar mayor latencia y/o errores de conexión.

GEThttps://api.migo.pe/api/v2/ruc/representantes-legales/{ruc}

Authorization

bearerAuth

Path parameters

ruc*string

Example: "20603274742"

Response

200403404

OK

Body

application/json

successboolean

Example: true

dataarray of LegalRepresentative (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.migo.pe/api/v2/ruc/representantes-legales/{ruc}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Response

200

{
  "success": true,
  "data": [
    {
      "documento": "DNI",
      "dni": "07710834",
      "nombre": "CASAVERDE MENDEZ MARITZA CECILIA",
      "cargo": "SUB GERENTE",
      "fecha": "2023-01-01",
      "ruc": "20131380951"
    }
  ]
}