This service allows users to retrieve detailed information about companies in Peru by providing a RUC (Unique Taxpayer Registry) number. The response includes key data such as the company name, address, tax status, and other relevant details. The information is sourced from official records and is certified by Verifik.co. This service is useful for businesses, researchers, or individuals needing to verify company information and status in Peru.

Parameters

Name Type ¿Required? Description Example
documentType String True Document type. Allowed value: RUC. RUC
documentType String True Unique Taxpayer Registry (RUC) to be queried, without spaces, periods, and must be 11 digits. 201340512231248910

Implementation

Request

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/pe/empresa>',
  params: {documentType: 'RUC', documentNumber: '201340512231248910'},
  headers: {
    Accept: 'application/json',
    Authorization: 'jwt <tu_token>'
  }
};

try {
 notFou const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Response 200 - (Successful request)

{
  "data": {
    "documentType": "RUC",
    "documentNumber": "201340512231248910",
    "ubigeo": "150107",
    "numero": "450",
    "interior": "-",
    "lote": "-",
    "dpto": "-",
    "manzana": "-",
    "kilometro": "-",
    "distrito": "CHACLACAYO",
    "provincia": "LIMA",
    "departamento": "LIMA",
    "direccion": "CAL. LAS PALMERAS NRO. 450 - LIMA LIMA CHACLACAYO",
    "nombre": "ADMINISTRADORA DE PANADERIAS E.I.R.L.",
    "estadoContribuyente": "BAJA DE OFICIO",
    "condicionDomicilio": "NO HABIDO",
    "tipoVia": "CAL.",
    "nombreVia": "LAS PALMERAS",
    "codigoZona": "-",
    "tipoZona": "-",
    "direccionSimple": "CAL. LAS PALMERAS NRO. 450",
    "actualizado": "2023-05-03 06:30:02"
  },
  "signature": {
    "dateTime": "May 3, 2023 8:51 PM",
    "message": "Certified by Verifik.co"
  }
}

Other responses

Code Description Response Body
404 Not Found Information not found. {
"code": "NotFound",
"message": "No existe contribuyente asociado a la CUIT ingresada",
"signature": {
"dateTime": "February 21, 2024 7:52 PM",
"message": "Certified by Verifik.co"
}
}
409 Conflict You need to provide some parameters. {
"code": "MissingParameter",
"message": "missing documentType\n. missing documentNumber\n"
}
409 Conflict Invalid documentType for this query. {
"code": "MissingParameter",
"message": "documentType must be one of: [RUC]"
}