Endpoint: puesto de votación por cédula

Dónde le toca votar a una persona, por cédula, del censo electoral de la Registraduría. Devuelve el **puesto** con su nombre oficial, la **dirección**, el **número de mesa**, el **municipio y departamento**, el **código DIVIPOL** del puesto —el mismo con el que la Registraduría publica logística y resultados— y las **coordenadas** del sitio con enlace de navegación, cuando la fuente lo tiene georreferenciado. Trae además `fechaInscripcion`, que es desde cuándo la persona figura en ese puesto: eso delata a quien acaba de trasladarse. **No es estacional**: consulta el lugar de votación vigente y responde también fuera de calendario electoral. Sirve para logística de transporte el día de elecciones, verificación de residencia electoral y validación de datos de afiliados. ⚠️ **Solo cédula de ciudadanía** — el censo electoral no maneja otro documento, y cualquier otro tipo responde 400 sin cobrar. **Un documento que no figura en el censo responde 404 y NO cobra**: acá el producto es el puesto, y si no vino no se entregó nada. La fuente distingue dos formas de "no hay puesto": que el documento no figure en el censo, y que tenga una **novedad** que lo saca de él (cédula cancelada por muerte, no expedida). Las dos responden 404 con el mensaje textual del registro y ninguna cobra: el estado de la cédula es otra pregunta, y no la vendemos como si fuera esta. Cuesta 1 crédito.

Cuerpo de la solicitud

{
  "docType": "CC",
  "docNumber": "1020304050"
}

Ejemplos por lenguaje

curl -X POST 'https://placapi.com/api/puesto-votacion' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"docType":"CC","docNumber":"1020304050"}'

const res = await fetch("https://placapi.com/api/puesto-votacion", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"docType":"CC","docNumber":"1020304050"}),
});
const data = await res.json();

import requests

res = requests.post(
    "https://placapi.com/api/puesto-votacion",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"docType":"CC","docNumber":"1020304050"},
)
data = res.json()

Respuesta exitosa

{
  "source": "puesto-votacion",
  "status": "info",
  "data": {
    "documento": "1020304050",
    "departamento": "VALLE",
    "municipio": "CALI",
    "puesto": "INSTITUCION EDUCATIVA EJEMPLO",
    "direccion": "CALLE 00 # 00-00",
    "mesa": "24",
    "codigoPuesto": "310019914",
    "fechaInscripcion": "2026-02-07",
    "ubicacion": {
      "lat": 3.35393,
      "lng": -76.523,
      "mapsUrl": "https://www.google.com/maps/dir/?api=1&destination=3.35393,-76.52300"
    }
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z",
  "cost": 1
}

Errores y cobro

Cuesta 1 crédito cuando devuelve datos. Códigos posibles: 400 401 402 404 429 500 502 — qué significa cada uno, cuál reintentar y cuál cobra, en errores y rate limits. Autenticación por x-api-key: cómo generar la clave.