This service is used to obtain official and updated information about an Ecuadorian company based on its Unique Taxpayer Registry (RUC) number with a specific document type (e.g., RUCEC). It provides key details about the queried business entity, including its name, compliance status with obligations, taxpayer classification, and the validity period of the queried document.

Parameters

Name Type ¿Required? Description Example
documentType String True Document type. Valid parameter: RUCEC. RUCEC
documentType String True Document number to be queried, without spaces or dots, and it must be 13 digits long. 1793197955001

Implementation

Request

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/ec/company>',
  params: {documentType: 'RUCEC', documentNumber: '1234567891234'},
    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 response)

{
    "data": {
        "RUC": "1793197955001",
        "businessName": "PANADERÍA Y PASTELERIA 227 S.A.S.",
        "description": "AL DIA EN SUS OBLIGACIONES",
        "documentNumber": "1793197955001",
        "documentType": "RUCEC",
        "pendingObligations": null,
        "taxpayerClassification": "Otro",
        "validityPeriodDoc": "12 meses"
    },
    "signature": {
        "dateTime": "March 12, 2024 7:39 PM",
        "message": "Certified by Verifik.co"
    },
    "id": "5TN7E"
}

Other responses

Code Description Response Body
404 Not Found Information not found. {
"code": "NotFound",
"message": "Record not found.",
"signature": { 
"dateTime": "August 31, 2022 3:24 PM",
"message": "Certified by Verifik.co"

} } | | 409 | Conflict | Some parameters are missing. | { "code": "MissingParameter", "message": "missing documentType\n. missing documentNumber\n" } | | 409 | Conflict | Invalid documentType for this query. | { "code": "MissingParameter", "message": "documentType must be one of: [RUCEC]" } |