🇬🇹Guatemala

Service to query Salvadoran citizens using the DUI (Unique Identity Document).

Guatemalan Citizen Information

GET - https://api.verifik.co/v2/gt/cedula

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.

Implementation

Headers

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

Query 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

Request

JavaScript

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 {
  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/gt/cedula?documentNumber=123456789&documentType=CUI", 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/gt/cedula?documentNumber=123456789&documentType=CUI")!,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/gt/cedula?documentNumber=123456789&documentType=CUI');
$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": {
        "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"
}

404

{
    "code": "NotFound",
    "message": "Record not found.",
    "signature": {
        "dateTime": "August 31, 2022 3:24 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: [CUI]"
}