post
https://api-test.envia.com/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")
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Required Inputs
city,stateandcountryare all required — the request fails if any of them is missing.countrymust always beCO; this endpoint only resolves Colombian cities.stateis the 2-letter Colombian department code (e.g.AT,CN), not the full department name.
Notes
- If a required field is missing, the response returns
meta: "error"witherror.code: 1149and a message naming the missing field(s) (e.g."Missing required field(s): country."). Check the request body against the schema above before retrying. - If
city/state/countryare all present but no DANE municipality matches, the response returns the same error code with the message"Address cannot be validated."— double-check the spelling of the city and the department code.