Introducing Region Codes: Standardized ISO 3166-2 Support

We are excited to announce a valuable addition to our API responses: the regionCode field! 🎉

At FreeIPAPI.com, our mission is to provide developers with fast and actionable data. While our regionName field has always provided the full name of a state or province, we know that many of you need standardized identifiers for database storage, localization frameworks, and third-party integrations.

To address this, we have added a new field that returns the ISO 3166-2 code for the region.

What is the Region Code?

The regionCode field provides the short, standardized alphanumeric code for the principal subdivision of the country (such as a state, province, or region).

For example:

For California, United States, the code is CA.
For Bavaria, Germany, the code is BY.
For Ontario, Canada, the code is ON.

Example Response

The new field is available immediately in the JSON response. Here is an example of what a request looks like now:

{
    "ipVersion": 4,
    "ipAddress": "8.8.8.8",
    "latitude": 37.405992,
    "longitude": -122.078515,
    "countryName": "United States of America",
    "countryCode": "US",
    "timeZone": "-07:00",
    "zipCode": "94043",
    "cityName": "Mountain View",
    "regionName": "California",
    "regionCode": "CA",
    "isProxy": false,
    "continent": "Americas",
    "continentCode": "AM"
}

This update is part of our ongoing commitment to making FreeIPAPI the most developer-friendly geolocation service. This feature is live now and available to all users at no additional cost.

We can't wait to see what you build with it! 🚀