> For the complete documentation index, see [llms.txt](https://placapi.gitbook.io/placapi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://placapi.gitbook.io/placapi-docs/antecedentes-de-personas/puesto-de-votacion.md).

# Puesto de votación

`POST https://placapi.com/api/puesto-votacion`

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. Costo: 1 crédito por consulta con datos.

## Parámetros

| Campo       | Tipo    | Obligatorio | Detalle                                                                                                                                                                                                                       |
| ----------- | ------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `docType`   | string  | Sí          | Tipo de documento. El censo electoral es de ciudadanos colombianos y solo maneja cédula de ciudadanía: cualquier otro valor responde 400 `tipo_documento_no_soportado` sin cobrar y sin consultar a la fuente. Valores: `CC`. |
| `docNumber` | string  | Sí          | Número de cédula. Alias aceptado: `doc`.                                                                                                                                                                                      |
| `refresh`   | boolean | No          | Ignora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no).                                                                                            |

## Ejemplo

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

El esquema completo de la respuesta está en el [OpenAPI 3.1](https://placapi.com/openapi.json) y en la [referencia interactiva](https://placapi.github.io/reference.html).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://placapi.gitbook.io/placapi-docs/antecedentes-de-personas/puesto-de-votacion.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.