Serialized PHP endpoint


You can call the API by sending HTTP GET requests to http://ip-api.com/php/{query}

{query} can be an IP address or a domain, or none to use the current IP address.


Example

You can edit this query and experiment with the options

GET
Actual response
unserialized response

Returned data

The API can return the following fields and values

namedescriptionexampletype
statussuccess or failuresuccessstring
messageincluded only when status is failure
Can be one of the following: private range, reserved range, invalid query
invalid querystring
countryCountry nameUnited Statesstring
countryCodeTwo-letter country code ISO 3166-1 alpha-2USstring
regionRegion/state short code (FIPS or ISO)CA or 10string
regionNameRegion/stateCaliforniastring
cityCityMountain Viewstring
zipZip code94043string
latLatitude37.4192float
lonLongitude-122.0574float
timezoneCity timezoneAmerica/Los_Angelesstring
ispISP nameGooglestring
orgOrganization nameGooglestring
asAS number and name, separated by spaceAS15169 Google Inc.string
reverseReverse DNS of the IPwi-in-f94.1e100.netstring
mobileMobile (cellular) connectiontruebool
proxyProxy (anonymous)truebool
queryIP used for the query173.194.67.94string

Specifying returned data

If you don't require all the returned fields, use the GET parameter fields to specify which data should be returned.
Separate the fields by comma (fields=status,message,query,country,city) or use a generated, numeric value (to save bandwidth)

tick/untick all

generated fields


generated numeric

Localization

Localized city, regionName and country can be requested by setting the GET parameter lang to one of the following:

lang (ISO 639)description
enEnglish (default)
deDeutsch (German)
esEspañol (Spanish)
pt-BREspañol - Argentina (Spanish)
frFrançais (French)
ja日本語 (Japanese)
zh-CN中国 (Chinese)
ruРусский (Russian)

Usage limits

This endpoint is limited to 150 requests per minute from an IP address. If you go over this limit your IP address will be blackholed. You can unban here.

We do not allow commercial use of this endpoint. Please see our pro service for SSL access, unlimited queries and commercial support.