IPinfo

IPinfo Core API

IPinfo Core API - Core IP information service.

GitHub OpenAPI

Operations 4

GET /lookup/me IPinfo Returns Core IP Information About the Current IP #
GET /lookup/{ip} IPinfo Returns Core IP Information About the Provided IP #
GET /lookup/me/{field} IPinfo Returns a Specific Field from Core IP Information About the Current IP #
GET /lookup/{ip}/{field} IPinfo Returns a Specific Field from Core IP Information About the Provided IP #

Documentation

📖
Documentation
https://ipinfo.io/developers
📖
APIReference
https://ipinfo.io/developers
📖
GettingStarted
https://ipinfo.io/developers/getting-started
📖
Authentication
https://ipinfo.io/developers#authentication
📖
GettingStarted
https://ipinfo.io/developers/lite-api
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/ipinfo/main/rate-limits/ipinfo-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/ipinfo/refs/heads/main/openapi/ipinfo-ipinfo-core-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/ipinfo/main/json-schema/
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/ipinfo/main/json-structure/

Other Resources

🔗
Examples
https://raw.githubusercontent.com/api-evangelist/ipinfo/main/examples/
🔗
SDKs
https://github.com/ipinfo/python
🔗
SDKs
https://github.com/ipinfo/node
🔗
SDKs
https://github.com/ipinfo/java
🔗
SDKs
https://github.com/ipinfo/go
🔗
SDKs
https://github.com/ipinfo/ruby
🔗
SDKs
https://github.com/ipinfo/php
🔗
SDKs
https://github.com/ipinfo/csharp
🔗
SDKs
https://github.com/ipinfo/rust
🔗
SDKs
https://github.com/ipinfo/perl
🔗
SDKs
https://github.com/ipinfo/swift
🔗
SDKs
https://github.com/ipinfo/erlang
🔗
SDKs
https://github.com/ipinfo/django
🔗
SDKs
https://github.com/ipinfo/laravel
🔗
SDKs
https://github.com/ipinfo/spring
🔗
SDKs
https://github.com/ipinfo/rails
🔗
SDKs
https://github.com/ipinfo/node-express
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/ipinfo/main/plans/ipinfo-plans-pricing.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/ipinfo-ipinfo-core-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

ipinfo-ipinfo-core-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: Official OpenAPI Specification for IPinfo's comprehensive IP intelligence API.
  version: 1.0.0
  title: IPinfo.io OpenAPI Specification ipinfo core API
  contact:
    name: IPinfo
    email: support@ipinfo.io
    url: https://ipinfo.io/
servers:
- url: https://ipinfo.io/
- url: https://v6.ipinfo.io/
- url: https://api.ipinfo.io/
tags:
- name: ipinfo core
  description: IPinfo Core API - Core IP information service.
  externalDocs:
    description: Find more info here
    url: https://ipinfo.io/products/core
paths:
  /lookup/me:
    get:
      tags:
      - ipinfo core
      summary: IPinfo Returns Core IP Information About the Current IP
      description: Returns comprehensive core IP information about the current IP including geolocation, ASN details, and various IP characteristics.
      operationId: getCurrentCoreInformation
      servers:
      - url: https://api.ipinfo.io/
      - url: https://v4.api.ipinfo.io/
      - url: https://v6.api.ipinfo.io/
      security:
      - BasicAuth: []
      - BearerAuth: []
      - ApiKeyAuth: []
      responses:
        '200':
          $ref: '#/components/responses/CoreResponse'
        '403':
          $ref: '#/components/responses/CoreForbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
  /lookup/{ip}:
    get:
      tags:
      - ipinfo core
      summary: IPinfo Returns Core IP Information About the Provided IP
      description: Returns comprehensive core IP information about the provided IP including geolocation, ASN details, and various IP characteristics.
      operationId: getCoreInformationByIp
      servers:
      - url: https://api.ipinfo.io/
      - url: https://v4.api.ipinfo.io/
      - url: https://v6.api.ipinfo.io/
      security:
      - BasicAuth: []
      - BearerAuth: []
      - ApiKeyAuth: []
      parameters:
      - $ref: '#/components/parameters/Ip'
      responses:
        '200':
          $ref: '#/components/responses/CoreResponse'
        '400':
          $ref: '#/components/responses/CoreBadRequest'
        '403':
          $ref: '#/components/responses/CoreForbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
  /lookup/me/{field}:
    get:
      tags:
      - ipinfo core
      summary: IPinfo Returns a Specific Field from Core IP Information About the Current IP
      description: Returns a specific field from core IP information about the current IP.
      operationId: getCurrentCoreField
      servers:
      - url: https://api.ipinfo.io/
      - url: https://v4.api.ipinfo.io/
      - url: https://v6.api.ipinfo.io/
      security:
      - BasicAuth: []
      - BearerAuth: []
      - ApiKeyAuth: []
      parameters:
      - $ref: '#/components/parameters/CoreField'
      responses:
        '200':
          $ref: '#/components/responses/CoreField'
        '403':
          $ref: '#/components/responses/CoreForbidden'
        '404':
          $ref: '#/components/responses/CoreInvalidField'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
  /lookup/{ip}/{field}:
    get:
      tags:
      - ipinfo core
      summary: IPinfo Returns a Specific Field from Core IP Information About the Provided IP
      description: Returns a specific field from core IP information about the provided IP.
      operationId: getCoreFieldByIp
      servers:
      - url: https://api.ipinfo.io/
      - url: https://v4.api.ipinfo.io/
      - url: https://v6.api.ipinfo.io/
      security:
      - BasicAuth: []
      - BearerAuth: []
      - ApiKeyAuth: []
      parameters:
      - $ref: '#/components/parameters/Ip'
      - $ref: '#/components/parameters/CoreField'
      responses:
        '200':
          $ref: '#/components/responses/CoreField'
        '400':
          $ref: '#/components/responses/CoreBadRequest'
        '403':
          $ref: '#/components/responses/CoreForbidden'
        '404':
          $ref: '#/components/responses/CoreInvalidField'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    CoreErrorBadRequest:
      type: object
      required:
      - error
      properties:
        error:
          type: string
          example: Please provide a valid IP address
    CoreResponse:
      type: object
      required:
      - ip
      properties:
        ip:
          type: string
          example: 8.8.8.8
        hostname:
          type: string
          example: dns.google
        geo:
          type: object
          properties:
            city:
              type: string
              example: Mountain View
            region:
              type: string
              example: California
            region_code:
              type: string
              example: CA
            country:
              type: string
              example: United States
            country_code:
              type: string
              example: US
            continent:
              type: string
              example: North America
            continent_code:
              type: string
              example: NA
            latitude:
              type: number
              example: 37.4056
            longitude:
              type: number
              example: -122.0775
            timezone:
              type: string
              example: America/Los_Angeles
            postal_code:
              type: string
              example: '94043'
        as:
          type: object
          properties:
            asn:
              type: string
              example: AS15169
            name:
              type: string
              example: Google LLC
            domain:
              type: string
              example: google.com
            type:
              type: string
              example: hosting
        is_anonymous:
          type: boolean
          example: false
        is_anycast:
          type: boolean
          example: true
        is_hosting:
          type: boolean
          example: true
        is_mobile:
          type: boolean
          example: false
        is_satellite:
          type: boolean
          example: false
    CoreErrorInvalidField:
      type: object
      required:
      - error
      properties:
        error:
          type: string
          example: invalid_field is not a valid field.
    Error500:
      type: string
      example: Internal server error
    Error429:
      type: object
      required:
      - title
      - message
      properties:
        title:
          type: string
          example: Rate limit exceeded
        message:
          type: string
          example: Upgrade to increase your usage limits at https://ipinfo.io/pricing, or contact us via https://ipinfo.io/support
    CoreErrorForbidden:
      type: object
      required:
      - status
      - error
      properties:
        status:
          type: integer
          example: 403
        error:
          type: object
          required:
          - title
          - message
          properties:
            title:
              type: string
              example: Unknown token
            message:
              type: string
              example: Please ensure you've entered your token correctly. Refer to https://ipinfo.io/developers for details, or contact us at support@ipinfo.io for help
  responses:
    TooManyRequests:
      description: Allocated API rate limit has been reached for the token. The user will be prompted with options to increase their API limit.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error429'
    InternalServerError:
      description: Internal server error or server unavailable.
      content:
        text/plain:
          schema:
            $ref: '#/components/schemas/Error500'
    CoreField:
      description: A specific field value from the core response.
      content:
        text/plain:
          schema:
            type: string
            example: Mountain View
        application/json:
          schema:
            type: object
            example:
              city: Mountain View
              region: California
    CoreForbidden:
      description: Forbidden error (authentication issues).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/CoreErrorForbidden'
    CoreInvalidField:
      description: Invalid field name error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/CoreErrorInvalidField'
    CoreResponse:
      description: Core response object.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/CoreResponse'
    CoreBadRequest:
      description: Bad request error (invalid IP format).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/CoreErrorBadRequest'
  parameters:
    CoreField:
      name: field
      in: path
      description: A specific field from the core response or nested geo/as fields.
      required: true
      schema:
        type: string
        enum:
        - ip
        - hostname
        - geo
        - geo/city
        - geo/region
        - geo/region_code
        - geo/country
        - geo/country_code
        - geo/continent
        - geo/continent_code
        - geo/latitude
        - geo/longitude
        - geo/timezone
        - geo/postal_code
        - as
        - as/asn
        - as/name
        - as/domain
        - as/type
        - is_anonymous
        - is_anycast
        - is_hosting
        - is_mobile
        - is_satellite
    Ip:
      name: ip
      in: path
      description: A single IPv4 or IPv6 IP address.
      required: true
      schema:
        type: string
  securitySchemes:
    BasicAuth:
      type: http
      scheme: basic
    BearerAuth:
      type: http
      scheme: bearer
    ApiKeyAuth:
      type: apiKey
      in: query
      name: token
externalDocs:
  description: IPinfo Developers Portal / Documentation
  url: https://ipinfo.io/developers