get_country_cities (GET)

This function retrieves the states or provinces, and cities of a country, that are registered and active on our platform. It takes as input the token, ISO country (get_countries calls), and language (get_languages calls). It returns a string serialized in JSON format with the full name of the country, its cities and states, and their ISO codes (International Organization for Standardization).

  • Endpoint : preview.ilsbsys.com/apirest_v1/information

Input Fields

Tag Name Type Size Priority
token string 16 (Mandatory)
iso_country string 2 (Mandatory)
language string 3 (Mandatory)


Fields

{
    "request" : "get_country_cities",
    "token" : "123456789ABC",
    "iso_country" : "CO",
    "language" : "eng"
}

Results

[
    {
        "countries_description": "Colombia",
        "cities_description": "Baranoa",
        "iso_city": "3689235",
        "states_description": "Atlantico",
        "iso_state": "CO.04"
    },
    {
        "countries_description": "Colombia",
        "cities_description": "Barranquilla",
        "iso_city": "3689147",
        "states_description": "Atlantico",
        "iso_state": "CO.04"
    },
    {
        "countries_description": "Colombia",
        "cities_description": "Campo de la Cruz",
        "iso_city": "3687758",
        "states_description": "Atlantico",
        "iso_state": "CO.04"
    },
    {
        "countries_description": "Colombia",
        "cities_description": "Candelaria",
        "iso_city": "3687634",
        "states_description": "Atlantico",
        "iso_state": "CO.04"
    },
    {
        "countries_description": "Colombia",
        "cities_description": "Galapa",
        "iso_city": "3682238",
        "states_description": "Atlantico",
        "iso_state": "CO.04"
    },
    {
        "countries_description": "Colombia",
        "cities_description": "Juan de Acosta",
        "iso_city": "3680176",
        "states_description": "Atlantico",
        "iso_state": "CO.04"
    },
    {
        "countries_description": "Colombia",
        "cities_description": "Luruaco",
        "iso_city": "3675826",
        "states_description": "Atlantico",
        "iso_state": "CO.04"
    },
    {
        "countries_description": "Colombia",
        "cities_description": "Malambo",
        "iso_city": "3675595",
        "states_description": "Atlantico",
        "iso_state": "CO.04"
    },
    {
        "countries_description": "Colombia",
        "cities_description": "Manati",
        "iso_city": "3675512",
        "states_description": "Atlantico",
        "iso_state": "CO.04"
    },
    {
        "countries_description": "Colombia",
        "cities_description": "Palmar de Varela",
        "iso_city": "3673220",
        "states_description": "Atlantico",
        "iso_state": "CO.04"
    },
    {
        "countries_description": "Colombia",
        "cities_description": "Piojo",
        "iso_city": "3672176",
        "states_description": "Atlantico",
        "iso_state": "CO.04"
    }
]

Common Error Codes

  • 9173 : invalid Iso country
  • 9174 : ISO country is empty
  • 6021 : language is empty
  • 1030 : language not implemented
  • 1005 : supplied token is invalid