---
title: "Resolver geografías (DIVIPOLA)"
method: GET
path: "/v1/geografias"
tags: ["Geografías"]
---

# Resolver geografías (DIVIPOLA)

`GET /v1/geografias`

## Request

- Base URL: `https://api.alfil.co`
- URL: `https://api.alfil.co/v1/geografias`
- Auth: OAuth 2 (authorization code, authorization URL `https://api.alfil.co/oauth/authorize`, token URL `https://api.alfil.co/oauth/token`, scopes: `buscar:read`)

Resuelve nombres de lugares a códigos DIVIPOLA. Reutilizada por electoral/contratación/finanzas.

## Query parameters

- `q` string
- `departamento` string
- `nivel` 'departamento' | 'municipio'

## Response `200`

Entradas geográficas

- GeografiasResponse
  - `data` Geografia[], required
    - `divipola` string, required: Código DIVIPOLA (5 dígitos para municipio)
    - `nombre` string, required
    - `nivel` 'departamento' | 'municipio', required
    - `departamento` object
      - `divipola` string, required
      - `nombre` string, required

## Other responses

- `401`: Token faltante, expirado o de emisor inesperado
- `403`: Scope insuficiente
- `429`: Cuota agotada o rate limit

---

[API](https://skmtc.dev/alfil/apis/alfil-api.md) · [All operations](https://skmtc.dev/alfil/apis/alfil-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alfil/apis/alfil-api/revisions/e2545a4c45a5?raw)