🇨🇷Costa Rica

Service to query Costa Rican company information using the NITE (Taxpayer Identification Number).

Endpoint

https://api.verifik.co/v2/cr/company

The Costa Rican Companies Information service provides essential details about companies registered in Costa Rica. By providing the type and number of the company's document, such as the NITE (Foreigner Tax Identification Number), users can access fundamental information about the company.

This service is valuable for verifying company details and conducting business-related checks in Costa Rica.

To use this service in a graphical interface, we invite you to access our client panel at Verifik.

Headers

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

Query Parameters

Name	Type	Required?	Description	Example
documentType	String	True	Document type. Allowed parameter: NITE.	NITE
documentNumber	String	True	Document number to be queried, without spaces or dots, and must be more than 5 digits.	33516727409

Request

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/cr/company>',
  params: {documentType: 'NITE', documentNumber: '3101122876'},
  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/cr/company?documentType=NITE&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/cr/company?documentType=NITE&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/cr/company?documentType=NITE&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": {
    "businessName": "ENLACES CASUALES COSTA RICA SOCIEDAD ANONIMA",
    "documentNumber": "3101122876",
    "documentType": "RUCEC"
  },
  "signature": {
    "dateTime": "February 21, 2024 8:35 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "2PWJ0"
}

404

{
"code": "NotFound",
"message": "No existe contribuyente asociado a la NITE 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: [NITE]"
}