added
First-level administrative units: State names and ISO codes added
June 9th, 2024
We just added "first-level administrative divisions within a country" (usually called states or provinces by regular folks ;) to the API's JSON response as an explicit attribute. See stateName
for the colloquial name and the corresponding computer-friendly ISO code in stateCode
; note that one of both may be empty for smaller nations when no such civil divisions exist or when ISO hasn't assigned them a code.
Sign up to try the API here: Fastah on AWS Marketplace, or Fastah on Azure Marketplace.
{
"ip": "98.97.16.1",
"isEuropeanUnion": false,
"l10n": {
"currencyName": "Dollar",
"currencyCode": "USD",
"currencySymbol": "$",
"langCodes": [
"en-US",
"es-US",
"haw",
"fr"
]
},
"locationData": {
"countryName": "United States",
"countryCode": "US",
"stateName": "New York", // <--- First-level administrative unit, may be empty for smaller nations
"stateCode": "NY", // <--- ISO code of first-level administrative unit, may be empty for smaller nations
"cityName": "New York City, NY",
"cityGeonamesId": 5128581,
"lat": 40.71,
"lng": -74.01,
"tz": "America/New_York",
"continentCode": "NA"
},
"satellite": {
"provider": "SpaceX Starlink"
}
}