Public API Version is also available. Links are below:

http://countrystatecity.org/

http://countrystatecity.org/docs/gettingstarted

http://api.countrystatecity.org/swagger/

Request API key here

Country City Data Service

This service has data of all Countries and their States, Cities. This allows user to use this as service and provides the public server actions, service actions and exposed rest endpoints to use this data. 

Let's go over all Service, Server Actions and Rest Endpoints

• Server Actions:
  • GetAllCountriesList:            This will return all the Countries available in the database.
  • GetCountryById:                  This will return the single country matching the ID passed as input parameter.
  • GetCountryByCode:            This will return the single country matching the Country Code (e.g. IN for India) passed as input parameter.
  • GetAllStatesList:                  This will return all the states available in the database.
  • GetStateById:                       This will return the single state matching the ID passed as input parameter.
  • GetStateByCode:                 This will return the single state matching the State Code (e.g. UP for Uttar Pradesh) passed as input parameter.
  • GetStatesByCountryID:       This will return all the states available in the database matching the Country ID.
  • GetStatesByCountryCode:  This will return all the states available in the database matching the Country Code.
  • GetAllCitiesList:                          This will return all the Cities available in the database.
  • GetCityById:                          This will return the single city matching the ID passed as input parameter.
  • GetCitiesByStateId:              This will return all the cities matching the state id passed as input parameter.
  • GetCitiesByStateCode:        This will return all the cities matching the state code passed as input parameter.
  • GetCitiesByCountryId:         This will return all the cities matching the country id passed as input parameter.
  • GetCitiesByCountryCode:   This will return all the cities matching the country code passed as input parameter.

• Service Actions:
  • GetAllCountriesList_SA:            This will return all the Countries available in the database.
  • GetCountryById_SA:                  This will return the single country matching the ID passed as input parameter.
  • GetCountryByCode_SA:            This will return the single country matching the Country Code (e.g. IN for India) passed as input parameter.
  • GetAllStatesList_SA:                  This will return all the states available in the database.
  • GetStateById_SA:                       This will return the single state matching the ID passed as input parameter.
  • GetStateByCode_SA:                 This will return the single state matching the State Code (e.g. UP for Uttar Pradesh) passed as input parameter.
  • GetStatesByCountryID_SA:       This will return all the states available in the database matching the Country ID.
  • GetStatesByCountryCode_SA:  This will return all the states available in the database matching the Country Code.
  • GetAllCitiesList_SA:                          This will return all the Cities available in the database.
  • GetCityById_SA:                          This will return the single city matching the ID passed as input parameter.
  • GetCitiesByStateId_SA:              This will return all the cities matching the state id passed as input parameter.
  • GetCitiesByStateCode_SA:        This will return all the cities matching the state code passed as input parameter.
  • GetCitiesByCountryId_SA:         This will return all the cities matching the country id passed as input parameter.
  • GetCitiesByCountryCode_SA:   This will return all the cities matching the country code passed as input parameter.

• Exposed REST Endpoints:
  • getAllCountries:                  This will return all the Countries available in the database.
  • getCountryById:                  This will return the single country matching the ID passed as input parameter.
  • getCountryByCode:            This will return the single country matching the Country Code (e.g. IN for India) passed as input parameter.
  • getAllStates:                        This will return all the states available in the database.
  • getStateById:                       This will return the single state matching the ID passed as input parameter.
  • getStateByCode:                 This will return the single state matching the State Code (e.g. UP for Uttar Pradesh) passed as input parameter.
  • getStatesByCountryID:       This will return all the states available in the database matching the Country ID.
  • getStatesByCountryCode:  This will return all the states available in the database matching the Country Code.
  • getAllCities:                          This will return all the Cities available in the database.
  • getCityById:                          This will return the single city matching the ID passed as input parameter.
  • getCitiesByStateId:              This will return all the cities matching the state id passed as input parameter.
  • getCitiesByStateCode:        This will return all the cities matching the state code passed as input parameter.
  • getCitiesByCountryId:         This will return all the cities matching the country id passed as input parameter.
  • getCitiesByCountryCode:   This will return all the cities matching the country code passed as input parameter.

Rest Documentation

https://your-personal-environment/CountryStateCityData/rest/v1/