Costa Rica - Lieu de vote

Verifik interroge le registre électoral Donde Votar du TSE avec CCCR (cédula costaricienne, 9 à 13 chiffres). Utilisez ce point de terminaison pour la vérification électorale, l'intégration des électeurs et la conformité lorsque les données électorales costariciennes sont autorisées.

Retourne les détails du lieu de vote lorsque la source les fournit :

• documentType — valeur autorisée : CCCR
• documentNumber — cédula costaricienne (9 à 13 chiffres)
• fullName, firstName, firstLastName, secondLastName — nom du citoyen dans le registre électoral
• gender — code de sexe lorsque la source le fournit
• province, canton, district — résidence et géographie électorale
• pollingPlace, pollingTable — détails du bureau de vote
• electoralCode, electorNumber, schoolAddress — métadonnées de junta du TSE
• Champs optionnels — latitude, longitude lorsque la source les inclut
• Réponse signée par Verifik

Endpoint

GET v2/cr/votacion

Interrogez le registre Donde Votar du TSE avec documentType CCCR et un documentNumber de 9 à 13 chiffres. Les réponses réussies incluent le bureau de vote, la junta (table), la province, le canton et le district pour les flux KYC, vérification électorale et conformité.

Headers

Header	Valeur	Description
Accept	application/json	Format de réponse
Authorization	Bearer <token>	Votre JWT Verifik

Paramètres

Champ	Type	Requis	Description	Exemple
documentType	String	Oui	Type de document. Valeur autorisée : CCCR.	CCCR
documentNumber	String	Oui	Cédula costaricienne (9 à 13 chiffres).	401310036

Requête

JavaScript

const { data } = await axios.get("https://api.verifik.co/v2/cr/votacion", {
  params: {
    documentType: "CCCR",
    documentNumber: "401310036",
  },
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
  },
});
console.log(data);

Python

url = "https://api.verifik.co/v2/cr/votacion"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CCCR", "documentNumber": "401310036"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Réponse

200

{
  "data": {
    "documentType": "CCCR",
    "documentNumber": "401310036",
    "fullName": "MARIA ELENA LOPEZ GARCIA",
    "firstName": "MARIA",
    "firstLastName": "LOPEZ",
    "secondLastName": "GARCIA",
    "gender": "1",
    "province": "San José",
    "canton": "Central",
    "district": "Carmen",
    "pollingPlace": "Escuela República de Chile",
    "pollingTable": "12",
    "electoralCode": "210011",
    "electorNumber": "325",
    "schoolAddress": "COSTADO NORTE DE LA PLAZA DE DEPORTES",
    "latitude": 9.9281,
    "longitude": -84.0907
  },
  "signature": {
    "dateTime": "July 13, 2026 5:00 PM",
    "message": "Certified by Verifik.co"
  }
}

404

{
  "code": "NotFound",
  "message": "Record not found."
}

409

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

Notes

• documentType doit être CCCR ; documentNumber doit comporter 9 à 13 chiffres numériques.
• Exemples en production : 401310036, 401310030, 401310039, 402330708, 114070037.
• Mode sandbox : utilisez les identifiants de test 010000001 à 010000010 pour des profils stables ; 090040401 renvoie 404.
• Traitez les réponses comme des données personnelles sensibles ; respectez les lois sur la vie privée applicables.
• Voir aussi : Citoyen costaricien (CCCR).