Sign in

v1

latestOpenAPI 3.1.0Proprietary2026-07-24710198.3 KB
Utilities

Locate a City (Colombia)

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")
post/locate

Request body

citystring required

City name to search. Accepts partial or full city name.

statestring required

2-letter Colombian department code (e.g. AT for Atlántico, CN for Cundinamarca).

countrystring required

ISO country code. Must be CO (Colombia).

Example request

{
  "city": "Soledad",
  "state": "AT",
  "country": "CO"
}

Response

City resolved successfully

citystring

8-digit DANE municipal code. Use this value in the city field of origin/destination in /ship/rate and /ship/generate for Colombian carriers.

namestring

Normalized municipality name as registered in the DANE catalog.

statestring

2-letter department code.

Example response

{
  "city": "08758000",
  "name": "SOLEDAD",
  "state": "AT"
}