🇺🇾Uruguay

Service to consult citizens of Uruguay using the CC (Citizenship Card).

Información del ciudadano uruguayo

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

Este servicio de Uruguay permite verificar la validez de una cédula de identidad uruguaya utilizando el tipo de documento CCUY, junto con el número de documento y la fecha de nacimiento proporcionados. Además de validar el documento, es posible obtener información detallada como el nombre completo, los nombres y los apellidos de la persona asociada al número de documento ingresado.

Implementación

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 be consulted.	123456789
documentType	String	True	Type of document to consult. Allowed parameter: CCUY.	CUI
dateOfBirth	String	True	Date of birth in the following format (DD/MM/YYYY)	20/02/1978

Request

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/uy/cedula>',
  params: { documentNumber: '123456789', documentType:'CCUY', dateOfBirth: '20/02/1978'},
  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 requests

options = {
    'method': 'GET',
    'url': 'https://api.verifik.co/v2/uy/cedula',
    'params': {'documentNumber': '123456789', 'documentType': 'CCUY', 'dateOfBirth': '20/02/1978'},
    'headers': {
        'Accept': 'application/json',
        'Authorization': 'jwt <tu_token>'
    }
}

try:
    response = requests.request(options['method'], options['url'], params=options['params'], headers=options['headers'])
    data = response.json()
    print(data)
except Exception as error:
    print(error)

Swift

import Foundation

let url = URL(string: "https://api.verifik.co/v2/uy/cedula")!
var request = URLRequest(url: url)
request.httpMethod = "GET"
request.setValue("application/json", forHTTPHeaderField: "Accept")
request.setValue("jwt <tu_token>", forHTTPHeaderField: "Authorization")

let params: [String: String] = ["documentNumber": "123456789", "documentType": "CCUY", "dateOfBirth": "20/02/1978"]
let queryItems = params.map { URLQueryItem(name: $0.key, value: $0.value) }
var urlComponents = URLComponents(url: url, resolvingAgainstBaseURL: false)!
urlComponents.queryItems = queryItems
request.url = urlComponents.url

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let error = error {
        print(error)
        return
    }
    
    guard let data = data else { return }
    
    do {
        let json = try JSONSerialization.jsonObject(with: data, options: [])
        print(json)
    } catch {
        print(error)
    }
}

task.resume()

PHP

<?php

$options = [
    'http' => [
        'header' => [
            'Accept: application/json',
            'Authorization: jwt <tu_token>'
        ],
        'method' => 'GET',
    ]
];

$context = stream_context_create($options);
$url = 'https://api.verifik.co/v2/uy/cedula?documentNumber=123456789&documentType=CCUY&dateOfBirth=20/02/1978';

try {
    $data = file_get_contents($url, false, $context);
    echo $data;
} catch (Exception $error) {
    echo $error->getMessage();
}

?>

Response

200

{
    "data": {
        "arrayName": [
            "MATEO",
            "VERIFIK"
        ],
        "dateOfBirth": "1973-03-03",
        "documentNumber": "12345678909876",
        "documentType": "CCUY",
        "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: [CCUY]"
}