Description

This endpoint allows you to verify the validity of a Guatemalan ID by providing the CUI document type and the document number. The response confirms whether the ID is valid and provides details related to the document.

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

Parameters

Name Type ¿Required? Description Example
documentNumber String True Document number of the person to consult. 123456789
documentType String True Type of document to consult. Allowed parameter: CUI. CUI

Implementation

Request

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/gt/cedula>',
  params: { documentNumber: '123456789', documentType:'CUI'},
  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": {
        "arrayName": [
            "MATEO",
            "VERIFIK"
        ],
        "documentNumber": "12345678909876",
        "documentType": "CUI",
        "firstName": "MATEO",
        "fullName": "MATEO VERIFIK",
        "lastName": "VERIFIK"
    },
    "signature": {
        "dateTime": "July 3, 2024 3:24 PM",
        "message": "Certified by Verifik.co"
    },
    "id": "YOESE"
}

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 parameter needs to be supplied. {
"code": "MissingParameter",
"message": "missing documentType\n. missing documentNumber\n"
}
409 Conflict Invalid document type for this query. {
"code": "MissingParameter",
"message": "documentType must be one of: [CUI]"
}