Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

IPinfo single API

Single info API.

IPinfo single API is one of 17 APIs that IPinfo publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include single. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, rate-limit docs, and 2 JSON Schemas.

This API exposes 18 operations across 18 paths, and defines 5 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against 3 base URLs: https://ipinfo.io/, https://v6.ipinfo.io/, https://api.ipinfo.io/.

18 operations 18 paths 5 schemas 18 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://api.ipinfo.io
Authentication
HTTP Basic, HTTP Bearer, API Key
Contact
Resource Areas
1

Authentication & Security 3

IPinfo single API declares 3 security schemes for authenticating requests. It accepts HTTP basic authentication (BasicAuth). It accepts HTTP bearer tokens (BearerAuth). An API key is passed in the query as token (ApiKeyAuth).

Paths & Operations 18

Across 18 paths, the API surfaces 18 operations — 18 GET. Each is listed below with its method, path, parameters, and response codes.

single 18

Single info API.

GET
/ip
IPinfo Returns the Current IP
getCurrentIp → 200403429500
GET
/{ip}/ip
IPinfo Returns a IP for the Selected IP
getIpByIp 1 param → 200404400403429500
GET
/hostname
IPinfo Returns the Current Hostname
getCurrentHostname → 200403429500
GET
/{ip}/hostname
IPinfo Returns a Hostname for the Selected IP
getHostnameByIp 1 param → 200400404403429500
GET
/city
IPinfo Returns the Current City
getCurrentCity → 200403429500
GET
/{ip}/city
IPinfo Returns a City for the Selected IP
getCityByIp 1 param → 200400404403429500
GET
/region
IPinfo Returns the Current Region
getCurrentRegion → 200403429500
GET
/{ip}/region
IPinfo Returns a Region for the Selected IP
getRegionByIp 1 param → 200400404403429500
GET
/country
IPinfo Returns the Current Country
getCurrentCountry → 200403429500
GET
/{ip}/country
IPinfo Returns a Country for the Selected IP
getCountryByIp 1 param → 200400404403429500
GET
/loc
IPinfo Returns the Current Location
getCurrentLocation → 200403429500
GET
/{ip}/loc
IPinfo GET a Location for the Selected IP
getLocationByIp 1 param → 200400404403429500
GET
/postal
IPinfo Returns the Current Postal Code or Zip Code
getCurrentPostal → 200403429500
GET
/{ip}/postal
IPinfo Returns a Postal for the Selected IP
getPostalByIp 1 param → 200400404403429500
GET
/timezone
IPinfo Returns the Current Timezone
getCurrentTimezone → 200403429500
GET
/{ip}/timezone
IPinfo Returns a Timezone for the Selected IP
getTimezoneByIp 1 param → 200400404403429500
GET
/org
IPinfo Returns the Current ASN and as Organization
getCurrentOrganization → 200404403429500
GET
/{ip}/org
IPinfo Returns a Organization for the Selected IP
getOrganizationByIp 1 param → 200400404403429500

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are Error403 (2 properties), Error404 (2 properties), Error400 (2 properties), Error429 (2 properties). Each schema is shown below with its type and property counts.

Error429
object
2 properties 2 required
Error400
object
2 properties 2 required
Error500
string
Error404
object
2 properties 2 required
Error403
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ipinfo-single-api-openapi.yml Raw ↑

Other APIs IPinfo publishes across the network.

IPinfo abuse API
IPinfo asn API
IPinfo carrier API
IPinfo company API
IPinfo domains API
IPinfo general API
IPinfo ipinfo core API
IPinfo ipinfo lite API
IPinfo ipinfo max API
IPinfo ipinfo plus API
IPinfo places API
IPinfo privacy detection API