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

Path parameters

rucstringrequired

Example: 20603274742

Header parameters

Acceptstringrequired

Example: application/json

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.migo.pe/api/v2/ruc/{ruc}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Accept: application/json'

200

403

404

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"
}

OK

Consulta RUC con actividades económicas

get

Authorizations

Path parameters

rucstringrequired

Example: 20603274742

Header parameters

Acceptstringrequired

Example: application/json

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.migo.pe/api/v2/ruc-actividad/{ruc}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Accept: application/json'

200

403

404

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"
  }
}

OK

Consulta RUC locales anexos

get

Authorizations

Path parameters

rucstringrequired

Example: 20131380951

Header parameters

Acceptstringrequired

Example: application/json

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.migo.pe/api/v2/ruc/anexos/{ruc}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Accept: application/json'

200

403

404

200

{
  "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"
    }
  ]
}

OK

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

Path parameters

rucstringrequired

Example: 20131380951

Header parameters

Acceptstringrequired

Example: application/json

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.migo.pe/api/v2/ruc-sunat/{ruc}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Accept: application/json'

200

403

404

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"
}

OK

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

get

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

Authorizations

Path parameters

rucstringrequired

Example: 20603274742

Header parameters

Acceptstringrequired

Example: application/json

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.migo.pe/api/v2/ruc/representantes-legales/{ruc}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Accept: application/json'

200

403

404

200

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

OK