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 lite API

IPinfo Lite API - IPinfo's free API service for country and ASN information.

IPinfo ipinfo lite 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 lite. 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 lite 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 lite 4

IPinfo Lite API - IPinfo's free API service for country and ASN information.

GET
/lite/me
IPinfo Returns Lightweight IP Information About the Current IP
getCurrentLiteInformation → 200403500
GET
/lite/{ip}
IPinfo Returns Lightweight IP Information About the Provided IP
getLiteInformationByIp 1 param → 200400403500
GET
/lite/me/{field}
IPinfo Returns a Specific Field from Lightweight IP Information About the Current IP
getCurrentLiteField 1 param → 200403404500
GET
/lite/{ip}/{field}
IPinfo Returns a Specific Field from Lightweight IP Information About the Provided IP
getLiteFieldByIp 2 params → 200400403404500

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are LiteResponse (8 properties), LiteErrorForbidden (2 properties), LiteBogonResponse (2 properties), LiteErrorInvalidField (1 property). Each schema is shown below with its type and property counts.

LiteResponse
object
8 properties 8 required
Error500
string
LiteErrorBadRequest
object
1 property 1 required
LiteBogonResponse
object
2 properties 2 required
LiteErrorForbidden
object
2 properties 2 required
LiteErrorInvalidField
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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