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

get
Autorizaciones
Parámetros de ruta
rucstringRequeridoExample: 20603274742
Parámetros de encabezado
AcceptstringRequeridoExample: application/json
Respuestas
200

OK

application/json
get
/ruc/{ruc}
GET /api/v2/ruc/{ruc} HTTP/1.1
Host: api.migo.pe
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/json

{
  "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 masiva de RUC

post

Permite consultar hasta 100 RUC en una sola petición.

Autorizaciones
Parámetros de encabezado
AcceptstringRequeridoExample: application/json
Cuerpo
Respuestas
200

OK

application/json
post
/ruc/masivo
POST /api/v2/ruc/masivo HTTP/1.1
Host: api.migo.pe
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/json
Content-Type: application/json
Content-Length: 23

{
  "ruc": [
    "20603274742"
  ]
}
{
  "success": true,
  "data": [
    {
      "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 actividad económica

get
Autorizaciones
Parámetros de ruta
rucstringRequeridoExample: 20603274742
Parámetros de encabezado
AcceptstringRequeridoExample: application/json
Respuestas
200

OK

application/json
get
/ruc/{ruc}/actividad-economica
GET /api/v2/ruc/{ruc}/actividad-economica HTTP/1.1
Host: api.migo.pe
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/json

{
  "success": true,
  "ruc": "20603274742",
  "estado": "ACTIVO",
  "condicion": "HABIDO",
  "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": "NO DISPONIBLE",
  "tipo_facturacion": "MANUAL/COMPUTARIZADO",
  "tipo_contabilidad": "COMPUTARIZADO",
  "comercio_exterior": "SIN ACTIVIDAD",
  "periodo": "202404"
}

Consulta masiva de RUC actividad económicas

post

Permite consultar hasta 100 RUC en una sola petición.

Autorizaciones
Parámetros de encabezado
AcceptstringRequeridoExample: application/json
Cuerpo
Respuestas
200

OK

application/json
post
/ruc/actividad-economica/masivo
POST /api/v2/ruc/actividad-economica/masivo HTTP/1.1
Host: api.migo.pe
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/json
Content-Type: application/json
Content-Length: 23

{
  "ruc": [
    "20603274742"
  ]
}
{
  "success": true,
  "data": [
    {
      "ruc": "20603274742",
      "estado": "ACTIVO",
      "condicion": "HABIDO",
      "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": "NO DISPONIBLE",
      "tipo_facturacion": "MANUAL/COMPUTARIZADO",
      "tipo_contabilidad": "COMPUTARIZADO",
      "comercio_exterior": "SIN ACTIVIDAD",
      "periodo": "202404"
    }
  ]
}

Consulta RUC buen contribuyente

get
Autorizaciones
Parámetros de ruta
rucstringRequeridoExample: 20492681220
Parámetros de encabezado
AcceptstringRequeridoExample: application/json
Respuestas
200

OK

application/json
get
/ruc/{ruc}/buen-contribuyente
GET /api/v2/ruc/{ruc}/buen-contribuyente HTTP/1.1
Host: api.migo.pe
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/json

{
  "success": true,
  "ruc": "20492681220",
  "nombre_o_razon_social": "GRUPO TREBOL S.A.C.",
  "a_partir_del": "2017-01-02",
  "resolucion": "RS 0230050171582"
}

Consulta RUC agente de retención

get
Autorizaciones
Parámetros de ruta
rucstringRequeridoExample: 20100007348
Parámetros de encabezado
AcceptstringRequeridoExample: application/json
Respuestas
200

OK

application/json
get
/ruc/{ruc}/agente-retencion
GET /api/v2/ruc/{ruc}/agente-retencion HTTP/1.1
Host: api.migo.pe
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/json

{
  "success": true,
  "ruc": "20100007348",
  "nombre_o_razon_social": "LIMA GAS S A",
  "a_partir_del": "2006-01-06",
  "resolucion": "RS R.S.037-2002"
}

Consulta RUC agente de percepción

get
Autorizaciones
Parámetros de ruta
rucstringRequeridoExample: 20100007348
Parámetros de encabezado
AcceptstringRequeridoExample: application/json
Respuestas
200

OK

application/json
get
/ruc/{ruc}/agente-percepcion
GET /api/v2/ruc/{ruc}/agente-percepcion HTTP/1.1
Host: api.migo.pe
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/json

{
  "success": true,
  "ruc": "20100007348",
  "nombre_o_razon_social": "LIMA GAS S A",
  "a_partir_del": "2006-01-04",
  "resolucion": "RS R.S.058-2006"
}

Consulta RUC entidad exceptuada de percepción

get
Autorizaciones
Parámetros de ruta
rucstringRequeridoExample: 20130534211
Parámetros de encabezado
AcceptstringRequeridoExample: application/json
Respuestas
200

OK

application/json
get
/ruc/{ruc}/entidad-exceptuada-percepcion
GET /api/v2/ruc/{ruc}/entidad-exceptuada-percepcion HTTP/1.1
Host: api.migo.pe
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/json

{
  "success": true,
  "ruc": "20130534211",
  "nombre_o_razon_social": "MUNICIPALIDAD DE SAN ISIDRO",
  "tipo": "SECTOR PÚBLICO"
}

Consulta RUC y actividades económicas

get

Consulta RUC que incluye información adicional sobre actividades económicas.

La consulta exitosa a esta ruta cuenta como 2 consultas individuales para efectos de límite de uso.

Autorizaciones
Parámetros de ruta
rucstringRequeridoExample: 20603274742
Parámetros de encabezado
AcceptstringRequeridoExample: application/json
Respuestas
200

OK

application/json
get
/ruc-actividad/{ruc}
GET /api/v2/ruc-actividad/{ruc} HTTP/1.1
Host: api.migo.pe
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/json

{
  "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",
  "actividad_economica": {
    "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 con actividades económicas y padrones

get

Consulta RUC que incluye información adicional sobre actividades económicas, buen contribuyente, agente de retención, agente de percepción y entidad exceptuada de percepción.

La información adicional puede no estar disponible para todos los RUCs. Se devuelve null en esos casos.

La consulta exitosa a esta ruta cuenta como 6 consultas individuales para efectos de límite de uso.

Autorizaciones
Parámetros de ruta
rucstringRequeridoExample: 20603274742
Parámetros de encabezado
AcceptstringRequeridoExample: application/json
Respuestas
200

OK

application/json
get
/ruc/{ruc}/padrones
GET /api/v2/ruc/{ruc}/padrones HTTP/1.1
Host: api.migo.pe
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/json

{
  "success": true,
  "data": [
    {
      "ruc": {
        "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"
      },
      "actividad_economica": {
        "success": true,
        "ruc": "20603274742",
        "estado": "ACTIVO",
        "condicion": "HABIDO",
        "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": "NO DISPONIBLE",
        "tipo_facturacion": "MANUAL/COMPUTARIZADO",
        "tipo_contabilidad": "COMPUTARIZADO",
        "comercio_exterior": "SIN ACTIVIDAD",
        "periodo": "202404"
      },
      "buen_contribuyente": {
        "success": true,
        "ruc": "20492681220",
        "nombre_o_razon_social": "GRUPO TREBOL S.A.C.",
        "a_partir_del": "2017-01-02",
        "resolucion": "RS 0230050171582"
      },
      "agente_retencion": {
        "success": true,
        "ruc": "20100007348",
        "nombre_o_razon_social": "LIMA GAS S A",
        "a_partir_del": "2006-01-06",
        "resolucion": "RS R.S.037-2002"
      },
      "agente_percepcion": {
        "success": true,
        "ruc": "20100007348",
        "nombre_o_razon_social": "LIMA GAS S A",
        "a_partir_del": "2006-01-04",
        "resolucion": "RS R.S.058-2006"
      },
      "entidad_exceptuada_percepcion": {
        "success": true,
        "ruc": "20130534211",
        "nombre_o_razon_social": "MUNICIPALIDAD DE SAN ISIDRO",
        "tipo": "SECTOR PÚBLICO"
      }
    }
  ]
}

Consulta RUC locales anexos

get
Autorizaciones
Parámetros de ruta
rucstringRequeridoExample: 20131380951
Parámetros de encabezado
AcceptstringRequeridoExample: application/json
Respuestas
200

OK

application/json
get
/ruc/{ruc}/anexos
GET /api/v2/ruc/{ruc}/anexos HTTP/1.1
Host: api.migo.pe
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/json

{
  "success": true,
  "data": [
    {
      "ruc": "20131380951",
      "ubigeo": "150113",
      "tipo_de_via": "AV.",
      "nombre_de_via": "SALAVERRY",
      "codigo_de_zona": "----",
      "tipo_de_zona": "COMERCIAL",
      "numero": "1388",
      "interior": "-",
      "lote": "-",
      "dpto": "-",
      "manzana": "-",
      "kilometro": "-",
      "distrito": "JESÚS MARÍA",
      "provincia": "LIMA",
      "departamento": "LIMA",
      "direccion": "AV. SALAVERRY NRO. 1388 ---- COMERCIAL - LIMA LIMA JESÚS MARÍA",
      "actualizado_en": "2023-11-04 17:00:00"
    }
  ]
}

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

Consulta RUC desde SUNAT

get

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

Autorizaciones
Parámetros de ruta
rucstringRequeridoExample: 20131380951
Parámetros de encabezado
AcceptstringRequeridoExample: application/json
Respuestas
200

OK

application/json
get
/ruc/{ruc}/sunat
GET /api/v2/ruc/{ruc}/sunat HTTP/1.1
Host: api.migo.pe
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/json

{
  "success": true,
  "ruc": "20603274742",
  "nombre_o_razon_social": "MIGO SOCIEDAD ANONIMA CERRADA - MIGO S.A.C.",
  "tipo_contribuyente": "SOCIEDAD ANONIMA CERRADA",
  "nombre_comercial": "-",
  "fecha_inscripcion": "07-06-2018",
  "fecha_inicio_actividades": "07-06-2018",
  "estado_del_contribuyente": "ACTIVO",
  "condicion_de_domicilio": "HABIDO",
  "departamento": "AREQUIPA",
  "provincia": "AREQUIPA",
  "distrito": "PAUCARPATA",
  "direccion": "AV. JORGE CHAVEZ NRO. 204 URB.  JORGE CHAVEZ",
  "sistema_emision_comprobante": "MANUAL/COMPUTARIZADO",
  "actividad_comercio_exterior": "SIN ACTIVIDAD",
  "sistema_contabilidad\"": "COMPUTARIZADO",
  "actividades_economicas": [
    "Principal - 6202 - CONSULTORÍA DE INFORMÁTICA Y GESTIÓN DE INSTALACIONES INFORMÁTICAS",
    "Secundaria 1 - 4651 - VENTA AL POR MAYOR DE ORDENADORES, EQUIPO PERIFÉRICO Y PROGRAMAS DE INFORMÁTICA"
  ],
  "sistema_emision_electronica": [
    "DESDE LOS SISTEMAS DEL CONTRIBUYENTE. AUTORIZ DESDE 27/07/2018",
    "GUIA DE REMISION DESDE 02/03/2021"
  ],
  "emisor_electronico_desde": "27-07-2018",
  "afiliado_ple_desde": "-",
  "padrones": [
    "NINGUNO"
  ]
}

Consulta representantes legales desde SUNAT

get

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

Autorizaciones
Parámetros de ruta
rucstringRequeridoExample: 20603274742
Parámetros de encabezado
AcceptstringRequeridoExample: application/json
Respuestas
200

OK

application/json
get
/ruc/{ruc}/representantes-legales
GET /api/v2/ruc/{ruc}/representantes-legales HTTP/1.1
Host: api.migo.pe
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/json

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

Consulta deuda coactiva desde SUNAT

get

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

Autorizaciones
Parámetros de ruta
rucstringRequeridoExample: 20100188628
Parámetros de encabezado
AcceptstringRequeridoExample: application/json
Respuestas
200

OK

application/json
get
/ruc/{ruc}/deuda-coactiva
GET /api/v2/ruc/{ruc}/deuda-coactiva HTTP/1.1
Host: api.migo.pe
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/json

{
  "success": true,
  "data": [
    {
      "monto_deuda": "28306004.00",
      "periodo_tributario": "2000 - 13",
      "fecha_inicio_cobranza": "2025-10-17",
      "entidad_asociada": "Tesoro Público",
      "ruc": "20100188628"
    }
  ]
}
AnteriorCuentaSiguienteTipo de cambio SUNAT

Última actualización