---
title: "Locate a City (Colombia)"
method: POST
path: "/locate"
tags: ["Utilities"]
---

# Locate a City (Colombia)

`POST /locate`

Resolve a Colombian city name to its 8-digit DANE municipal code and validated postal code — required for all Colombian carriers (Coordinadora, ServiEntrega, TCC, etc.).

**When to use:** Call this endpoint before `/ship/rate` or `/ship/generate` when shipping within Colombia. Colombian carriers require the DANE code in the `city` field of origin and destination addresses, not the human-readable city name.

**Key behaviors:**
- Full-text search against the official DANE municipality catalog
- Returns the DANE code (`city`), normalized name (`name`), and department code (`state`)
- No authentication required
- Colombia only (`country: "CO"`)

## Request body

- object
  - `city` string, required — City name to search. Accepts partial or full city name.
  - `state` string, required — 2-letter Colombian department code (e.g. AT for Atlántico, CN for Cundinamarca).
  - `country` string, required — ISO country code. Must be CO (Colombia).

## Response `200`

City resolved successfully

- object
  - `city` string — 8-digit DANE municipal code. Use this value in the city field of origin/destination in /ship/rate and /ship/generate for Colombian carriers.
  - `name` string — Normalized municipality name as registered in the DANE catalog.
  - `state` string — 2-letter department code.

## Other responses

- `422` — A required field (city, state or country) is missing, or the city/state/country combination could not be resolved to a DANE code

---

[API](https://skmtc.net/envia/apis/envia-shipping-api-complete-documentation.md) · [All operations](https://skmtc.net/envia/apis/envia-shipping-api-complete-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/envia/envia-shipping-api-complete-documentation/versions/39f9208959d6/schema)