🇨🇴Retrieve Voting Information for Colombian Citizens

Service to check a citizen's voting location using their national ID.

Retrieve Voting Information for Colombian Citizens

POST /users

The Voting Information service allows you to retrieve voting details from the “Registraduría Nacional del Estado Civil” for Colombian citizens. By providing the citizen’s document number, you can access information such as their address, department, municipality, polling table, and voting station.

This service is valuable for verifying voter registration and facilitating the voting process.

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, without spaces or points.	123456789

Request

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/co/registraduria/votacion>',
  params: {documentNumber: '123456789'},
    headers: {
    Accept: 'application/json',
    Authorization: 'jwt <tu_token>'
  }
};

try {
 notFou 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/co/registraduria/votacion?documentNumber=123456789", 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/co/registraduria/votacion?documentNumber=123456789")!,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/co/registraduria/votacion?documentNumber=123456789');
$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": {
    "NUIP": "1234567890",
    "address": "CRA 9 A # 18-74 SUR",
    "department": "BOGOTA D.C.",
    "documentNumber": "1234567890",
    "municipality": "BOGOTA. D.C.",
    "pollingTable": "3",
    "votingStation": "SOSIEGO"
  },
  "signature": {
    "dateTime": "May 24, 2023 2:37 PM",
    "message": "Certified by Verifik.co"
  }
}

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 documentNumber\n"
}