get_country_states_cities (GET)

This function retrieves the cities of a state or province that belong to a country, that are registered and active in our platform. It takes as input the token, ISO country (obtained from get_countries calls) and ISO states (obtained from get_country_states or get_country_cities calls) and languaje (obtained get_languages calls). It returns a string serialized in JSON format with full name of the country, state, its cities, and their ISO codes (International Standard Organization).

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

Input Fields

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


Fields

{
    "request" : "get_country_states_cities",
    "token" : "123456789ABC",
    "iso_country" : "CO",
    "iso_state" : "CO.14",
    "language" : "spa"
}

Results

[
    {
        "countries_description": "Colombia",
        "cities_description": "Calamar",
        "iso_city": "3687975",
        "states_description": "Departamento del Guaviare",
        "iso_state": "CO.14"
    },
    {
        "countries_description": "Colombia",
        "cities_description": "El Retorno",
        "iso_city": "3792387",
        "states_description": "Departamento del Guaviare",
        "iso_state": "CO.14"
    },
    {
        "countries_description": "Colombia",
        "cities_description": "Miraflores",
        "iso_city": "3674740",
        "states_description": "Departamento del Guaviare",
        "iso_state": "CO.14"
    },
    {
        "countries_description": "Colombia",
        "cities_description": "San Jose del Guaviare",
        "iso_city": "3828545",
        "states_description": "Departamento del Guaviare",
        "iso_state": "CO.14"
    }
]

Common Error Codes

  • 1030 : language not implemented
  • 6021 : language is emply
  • 9015 : no results
  • 9173 : invalid Iso Country
  • 9174 : ISO Country is emply
  • 9175 : country states is emply
  • 9176 : ISO states is emply
  • 9177 : invalid Iso state
  • 1005 : supplied token is invalid