For the complete documentation index, see llms.txt. This page is also available as Markdown.

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
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
rucstringRequiredExample: 20603274742
Header parameters
AcceptstringRequiredExample: application/json
Responses
200

OK

application/json
successbooleanOptional
rucstringOptional
nombre_o_razon_socialstringOptional
estado_del_contribuyentestringOptional
condicion_de_domiciliostringOptional
ubigeostringOptional
tipo_de_viastringOptional
nombre_de_viastringOptional
codigo_de_zonastringOptional
tipo_de_zonastringOptional
numerostringOptional
interiorstringOptional
lotestringOptional
dptostringOptional
manzanastringOptional
kilometrostringOptional
distritostringOptional
provinciastringOptional
departamentostringOptional
direccion_simplestringOptional
direccionstringOptional
actualizado_enstringOptional
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"
}

Información SUNAT actualizada al 31/07/2026

Consulta RUC con actividad económica

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
rucstringRequiredExample: 20603274742
Header parameters
AcceptstringRequiredExample: application/json
Responses
200

OK

application/json
successbooleanOptional
rucstringOptional
estadostringOptional
condicionstringOptional
tipostringOptional
actividad_economica_rev3_principalstringOptional
actividad_economica_rev3_secundariastringOptional
actividad_economica_rev4_principalstringOptional
numero_trabajadoresstringOptional
tipo_facturacionstringOptional
tipo_contabilidadstringOptional
comercio_exteriorstringOptional
periodostringOptional
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 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.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
rucstringRequiredExample: 20603274742
Header parameters
AcceptstringRequiredExample: application/json
Responses
200

OK

application/json
successbooleanOptional
rucstringOptional
nombre_o_razon_socialstringOptional
estado_del_contribuyentestringOptional
condicion_de_domiciliostringOptional
ubigeostringOptional
tipo_de_viastringOptional
nombre_de_viastringOptional
codigo_de_zonastringOptional
tipo_de_zonastringOptional
numerostringOptional
interiorstringOptional
lotestringOptional
dptostringOptional
manzanastringOptional
kilometrostringOptional
distritostringOptional
provinciastringOptional
departamentostringOptional
direccion_simplestringOptional
direccionstringOptional
actualizado_enstringOptional
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 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.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
rucstringRequiredExample: 20131380951
Header parameters
AcceptstringRequiredExample: application/json
Responses
200

OK

application/json
successbooleanOptional
rucstringOptional
nombre_o_razon_socialstringOptional
tipo_contribuyentestringOptional
nombre_comercialstringOptional
fecha_inscripcionstringOptional
fecha_inicio_actividadesstringOptional
estado_del_contribuyentestringOptional
condicion_de_domiciliostringOptional
departamentostringOptional
provinciastringOptional
distritostringOptional
direccionstringOptional
sistema_emision_comprobantestringOptional
actividad_comercio_exteriorstringOptional
sistema_contabilidadstringOptional
actividades_economicasstring[]Optional
sistema_emision_electronicastring[]Optional
emisor_electronico_desdestringOptional
afiliado_ple_desdestringOptional
padronesstring[]Optional
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.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
rucstringRequiredExample: 20603274742
Header parameters
AcceptstringRequiredExample: application/json
Responses
200

OK

application/json
successbooleanOptionalExample: true
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.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
rucstringRequiredExample: 20100188628
Header parameters
AcceptstringRequiredExample: application/json
Responses
200

OK

application/json
successbooleanOptionalExample: true
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"
    }
  ]
}

Last updated