Votación

Recuperar Información de Votación para Ciudadanos Colombianos

Endpoint

https://api.verifik.co/v2/co/registraduria/votacion

El servicio de Información de Votación permite recuperar detalles de votación de la "Registraduría Nacional del Estado Civil" para ciudadanos colombianos. Al proporcionar el número de documento del ciudadano, puedes acceder a información como su dirección, departamento, municipio, mesa de votación y puesto de votación.

Este servicio es valioso para verificar el registro de votantes y facilitar el proceso de votación.

Headers

Nombre	Valor
Content-Type	application/json
Authorization	Bearer <token>

Parámetros

Nombre	Tipo	Requerido	Descripción
documentNumber	string	Sí	Número de documento de la persona a consultar, sin espacios ni puntos.

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: 'Bearer <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")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer <token>"
}

conn.request("GET", "/v2/co/registraduria/votacion?documentNumber=123456789", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

Swift

import Foundation

let headers = [
  "Accept": "application/json",
  "Authorization": "Bearer <token>"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.verifik.co/v2/co/registraduria/votacion?documentNumber=123456789")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()

PHP

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.verifik.co/v2/co/registraduria/votacion?documentNumber=123456789', [
  'headers' => [
    'Accept' => 'application/json',
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();

Response

200

{
  "success": true,
  "data": {
    "documentNumber": "123456789",
    "firstName": "María",
    "lastName": "González",
    "fullName": "María González",
    "address": "Calle 123 #45-67",
    "department": "Cundinamarca",
    "municipality": "Bogotá D.C.",
    "pollingTable": "123",
    "votingStation": "Colegio San José",
    "votingStationAddress": "Carrera 7 #32-16",
    "status": "active"
  }
}

404

{
  "success": false,
  "error": "Votante no encontrado",
  "code": "VOTER_NOT_FOUND"
}

409

{
  "code": "MissingParameter",
  "message": "missing documentNumber\n"
}

Features

• Verificación de Registro de Votantes: Confirmar el estado de registro de votantes
• Información de Ubicación: Detalles sobre mesa y puesto de votación
• Datos Demográficos: Información sobre departamento y municipio
• Respuesta Estructurada: Formato de datos organizado para fácil integración
• Múltiples Lenguajes de Programación: Soporte para JavaScript, Python, PHP y Swift
• Manejo de Errores: Respuestas de error comprensivas para varios escenarios

Casos de Uso

• Verificación de Registro de Votantes: Confirmar el estado de registro de votantes
• Soporte del Día de Elecciones: Ayudar a los votantes a encontrar sus ubicaciones de votación
• Análisis Demográfico: Analizar la distribución de votantes y demografía
• Monitoreo Electoral: Rastrear la participación de votantes y registro
• Compromiso Cívico: Apoyar procesos democráticos y educación de votantes