Description

The Paraguayan Business Query service provides detailed information about Paraguayan companies. When making a query, the response provides key data such as the business name, document number and type (RUC - Unique Taxpayer Registry), full RUC, the group it belongs to, whether it is an invoicer, and the mandatory date from which certain requirements apply.

Parameters

Name Type Required? Description Example
documentNumber String True Company document number to consult. 80033331
documentType String True Document type. Allowed parameter: RUC. RUC

Implementation

Request

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/py/company>',
  params: {documentNumber: '1234567', documentType:'RUC'},
    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": {
        "businessName": "CONDOMINIO MANUEL ADOLFO FERREIRA BRUSQUETTI Y OTRO",
        "documentNumber": "80033331",
        "documentType": "RUC",
        "fullRuc": "80033331-4",
        "group": null,
        "invoicer": "N",
        "mandatoryDate": null
    },
    "signature": {
        "dateTime": "April 5, 2024 2:46 PM",
        "message": "Certified by Verifik.co"
    },
    "id": "ESKV4"
}

Other responses

Code Description Response Body
404 Not Found Not Found {
"code": "NotFound",
"message": "Record not found.",
"signature": {
"dateTime": "August 31, 2022 3:24 PM",
"message": "Certified by Verifik.co"
}
}
409 Conflict Missing params {
"code": "MissingParameter",
"message": "missing documentNumber\n"
}