Municipios

GET/api/v1/municipios

Lista todos los municipios con cobertura activa en Guatemala. La respuesta está cacheada por 1 hora a nivel de servidor y CDN.

Ejemplo

curl https://api.tpcxpress.com/api/v1/municipios \
  -H "Authorization: Bearer TOKEN"

const res = await fetch('https://api.tpcxpress.com/api/v1/municipios', {
  headers: { 'Authorization': `Bearer ${process.env.TPC_API_TOKEN}` },
})
const { data } = await res.json()
// data.municipios → array de { nombre }

import httpx, os
 
client = httpx.Client(
    base_url="https://api.tpcxpress.com/api/v1",
    headers={"Authorization": f"Bearer {os.environ['TPC_API_TOKEN']}"},
)
data = client.get("/municipios").raise_for_status().json()["data"]
# data["municipios"] → list of { "nombre": ... }

Respuesta 200

{
  "success": true,
  "data": {
    "municipios": [
      { "nombre": "Amatitlán" },
      { "nombre": "Chinautla" },
      { "nombre": "Guatemala" },
      { "nombre": "Mixco" },
      { "nombre": "San José Pinula" },
      { "nombre": "Santa Catarina Pinula" },
      { "nombre": "Villa Canales" },
      { "nombre": "Villa Nueva" }
    ],
    "total": 8
  }
}

Los municipios están ordenados alfabéticamente.

Headers de caché

Cache-Control: public, max-age=3600

El servidor renueva la lista automáticamente cada hora. Si se agrega o desactiva un municipio, puede tardar hasta 60 minutos en reflejarse.

Municipio con cobertura vs. sin cobertura

Usa este endpoint para poblar el selector de destino en tu UI — solo muestra municipios de esta lista para evitar errores de creación.

Relación con tarifas personalizadas

La lista de municipios incluye todos los municipios activos. Las tarifas por municipio específicas para tu empresa están disponibles en GET /api/v1/empresa bajo tarifasPersonalizadas.

Para calcular el costo exacto de un envío, usa POST /api/v1/cotizar.