TurnUp Locations
TurnUp REST-ful API returns location data ie. countries, states/regions and cities/town with their related currencies and geographical locations based on continents in JSON formats.
TurnUp Locations endpoints
| Method | Endpoint | Description |
|---|---|---|
| Continents | ||
| GET |
getContinents /continents |
GET list of Continents with their related Continent Codes. |
| GET |
getContinentByCode /continents/{continent_code} |
GET list of Continent data by specifying the requested Continent Code. |
| Countries | ||
| GET |
getCountries /countries |
GET a simple list of all Countries and their internal Country ID's. Suited for Drop-down Lists mapping Countries, States and Cities Selections. |
| GET |
getCountriesByName /countries/{country_name} |
GET Country or Countries Information by the respective Country Name. Return data includes States withing each Country/Countries returned. |
| GET |
getCountryByID /countries/cid/{id} |
GET simple Country information by the related country internal ID. |
| States & Regions | ||
| GET |
getStates /states |
GET list of States / Regions Data globally. |
| GET |
getStatesByName /states/{state_name} |
GET State or States information including individual Cities / Towns within the State by passing the requested State Name or the Region Name. |
| GET |
getStatesByCountryID /states/cid/{country_id} |
GET a list of State / Region within a Country by passing the internal Country ID. Suited for Drop-down Lists mapping Countries, States and Cities Selections. |
| Cities & Towns | ||
| GET |
getCitiesByName /cities/{city_name} |
GET a City or Cities Information by providing the requested the City Name. |
| GET |
getCitiesByCountryID /cities/cid/{country_id} |
GET list of Cities / Towns within a Country by passing the internal Country ID. |
| GET |
getCitiesByStateID /cities/sid/{state_id} |
GET simple list of Cities/Towns per State by passing the internal State ID. Suited for Drop-down Lists mapping Countries, States and Cities Selections. |
TurnUp Locations pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 45 / minute |
|
| PRO | $3 / month | 180 / minute |
|