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 ipinfo core API

IPinfo Core API - Core IP information service.

IPinfo ipinfo core 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 ipinfo core. 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 4 operations across 4 paths, and defines 6 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/.

4 operations 4 paths 6 schemas 4 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 ipinfo core 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 4

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

ipinfo core 4

IPinfo Core API - Core IP information service.

GET
/lookup/me
IPinfo Returns Core IP Information About the Current IP
getCurrentCoreInformation → 200403429500
GET
/lookup/{ip}
IPinfo Returns Core IP Information About the Provided IP
getCoreInformationByIp 1 param → 200400403429500
GET
/lookup/me/{field}
IPinfo Returns a Specific Field from Core IP Information About the Current IP
getCurrentCoreField 1 param → 200403404429500
GET
/lookup/{ip}/{field}
IPinfo Returns a Specific Field from Core IP Information About the Provided IP
getCoreFieldByIp 2 params → 200400403404429500

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are CoreResponse (9 properties), CoreErrorForbidden (2 properties), Error429 (2 properties), CoreErrorBadRequest (1 property). Each schema is shown below with its type and property counts.

Error500
string
CoreErrorInvalidField
object
1 property 1 required
Error429
object
2 properties 2 required
CoreErrorBadRequest
object
1 property 1 required
CoreResponse
object
9 properties 1 required
CoreErrorForbidden
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ipinfo-ipinfo-core-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 lite API
IPinfo ipinfo max API
IPinfo ipinfo plus API
IPinfo places API
IPinfo privacy detection API
IPinfo privacy detection extended API