🇵🇪Perú

Servicio para consultar empresas peruanas a través del RUC (Registro Único de Contribuyentes).

Endpoint

https://api.verifik.co/v2/pe/empresa

Este servicio permite a los usuarios obtener información detallada sobre empresas en Perú al proporcionar un número de RUC (Registro Único de Contribuyentes). La respuesta incluye datos clave como el nombre de la empresa, dirección, estado tributario y otros detalles relevantes. Este servicio es útil para empresas, investigadores o particulares que necesiten verificar la información y el estado de una empresa en Perú.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Query 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

Request

JavaScript

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 {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")
payload = ''
headers = {}
conn.request("GET", "/v2/pe/empresa?documentType=RUC&documentNumber=", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Swift

var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/pe/empresa?documentType=RUC&documentNumber=")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"

let task = URLSession.shared.dataTask(with: request) { data, response, error in 
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

PHP

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.verifik.co/v2/pe/empresa?documentType=RUC&documentNumber=');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}

Response

200

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

404

{
"code": "NotFound",
"message": "No existe contribuyente asociado a la RUT ingresada",
"signature": {
"dateTime": "February 21, 2024 7:52 PM",
"message": "Certified by Verifik.co"
}
}

409

{
"code": "MissingParameter",
"message": "missing documentType\n. missing documentNumber\n"
}

409

{
"code": "MissingParameter",
"message": "documentType must be one of: [RUC]"
}