×
the ant game

API Código Postal

The first step to use our API is to register an API Key. This service is free of charge. You can check the list of countries that current has the ZIP Code API working. There is a limitation of 200 daily requests. If you need more requests daily you can contact us.

So far the following methods are available.

  • Reverse geocoding
  • ZIP Code details

ZIP Code details

ZIP Code details turns a postal code into a readable locale information. For some countries, it will return even the street name. For others, ZIP Codes belongs to a big area, so it will return only states, cities and average latitude and longitude.

Request

						
https://codigo-postal.co/api/v1/zip-details/[API_KEY]/[TWO_LETTER_COUNTRY_CODE]/[POSTAL_CODE]/
						
					

Response

						
[
    {
        "country_iso_alfa_2": "CO",
        "country": "Colombia",
        "geodivision_1": "Bogotá D.C.",
        "geodivision_2": "Bogotá",
        "geodivision_3": "Usaquen",
        "postal_code": "111011",
        "latitude": 42.9934,
        "longitude": -84.1595
    }
]
						
					

Reverse geocoding

Reverse geocoding is the process of reverse coding of a point location (latitude, longitude) to a readable address or place name.

Request

https://codigo-postal.co/api/v1/zip-reverse/[API_KEY]/[LATITUDE]/[LONGITUDE]/

Response

						
[
    {
        "country_iso_alfa_2": "CO",
        "country": "Colombia",
        "geodivision_1": "Bogotá D.C.",
        "geodivision_2": "Bogotá",
        "geodivision_3": "Usaquen",
        "postal_code": "111011",
        "latitude": 42.9934,
        "longitude": -84.1595
    }
]