Skip to main content

IP Geolocation API

Available in: IPinfo Enterprise

The IPinfo IP Geolocation API returns the city, region, country, coordinates, timezone, and postal code associated with an IP address. It's part of the IPinfo Enterprise plan, where customers select the specific API services and request quota that match their needs.

Looking for a self-serve API instead? Our IPinfo Lite, IPinfo Core, IPinfo Plus, and IPinfo Max. See IP Geolocation Data for a comparison across all tiers.

Quick Reference

API Schema
JSON
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "IPinfo Enterprise API - Geolocation API Response",
  "description": "Schema for IPinfo Enterprise - IP Geolocation API response",
  "type": "object",
  "properties": {
    "ip": {
      "type": "string",
      "description": "The IP address being looked up.",
      "example": "37.67.193.154"
    },
    "city": {
      "type": "string",
      "description": "The city where the IP address is located.",
      "example": "Paris"
    },
    "region": {
      "type": "string",
      "description": "The region or state where the IP address is located.",
      "example": "Île-de-France"
    },
    "country": {
      "type": "string",
      "description": "The ISO 3166-1 alpha-2 country code of the IP address.",
      "example": "FR"
    },
    "loc": {
      "type": "string",
      "description": "The latitude and longitude coordinates of the IP address location, formatted as a comma-separated string.",
      "example": "48.8534,2.3488"
    },
    "postal": {
      "type": "string",
      "description": "The postal or zip code associated with the IP address location.",
      "example": "75000"
    },
    "timezone": {
      "type": "string",
      "description": "The local timezone of the IP address location, formatted according to the IANA Time Zone Database.",
      "example": "Europe/Paris"
    },
    "org": {
      "type": "string",
      "description": "The ASN and organization name associated with the IP address.",
      "example": "AS15557 Societe Francaise Du Radiotelephone - SFR SA"
    }
  }
}
FieldTypeDescriptionExample
ipstringThe IP address being looked up.37.67.193.154
citystringThe city where the IP address is located.Paris
regionstringThe region or state where the IP address is located.Île-de-France
countrystringThe ISO 3166-1 alpha-2 country code of the IP address.FR
locstringThe latitude and longitude coordinates of the IP address location, formatted as a comma-separated string.48.8534,2.3488
postalstringThe postal or zip code associated with the IP address location.75000
timezonestringThe local timezone of the IP address location, formatted according to the IANA Time Zone Database.Europe/Paris
orgstringThe ASN and organization name associated with the IP address.AS15557 Societe Francaise Du Radiotelephone - SFR SA

Unlike the Core/Plus/Max API tiers, the Enterprise API does not nest these fields under a geo object — they're returned at the top level of the response, alongside whichever other Enterprise services (ASN, Company, Privacy, Abuse, Domains) your plan includes.

Lookup IP addresses

Bash
curl https://ipinfo.io/37.67.193.154?token=$TOKEN
curl https://ipinfo.io/me?token=$TOKEN
API Response
JSON
{
  "ip": "37.67.193.154",
  "hostname": "example.fr",
  "city": "Paris",
  "region": "Île-de-France",
  "country": "FR",
  "loc": "48.8534,2.3488",
  "org": "AS15557 Societe Francaise Du Radiotelephone - SFR SA",
  "postal": "75000",
  "timezone": "Europe/Paris"
}

The response above shows only the geolocation-relevant fields. Depending on the services included in your Enterprise plan, the same response may also include asn, company, privacy, abuse, and domains objects — see IPinfo Enterprise for the full list.

If you are using an IPv6 connection, please use the v6.ipinfo.io endpoint.

Was this page helpful?