Packetrove IP API

Request-based IP address diagnostics.

GitHub OpenAPI

Operations 1

GET /v1/public-ip Get the IP address observed for the current request #

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/packetrove-com:packetrove-com-ip-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

packetrove-com-ip-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Packetrove IP API
  version: 0.8.0
  license:
    name: MIT
    url: https://opensource.org/license/mit/
  description: Network tools for humans and agents, including local calculations and request-based diagnostics. Address counts are decimal strings for exact IPv6 representation.
servers:
- url: /
  description: The host serving this specification
security: []
tags:
- name: Ip
  description: Request-based IP address diagnostics.
paths:
  /v1/public-ip:
    get:
      operationId: public-ip
      tags:
      - Ip
      summary: Get the IP address observed for the current request
      description: 'Returns one IPv4 or IPv6 address from the current connection to Packetrove. Request Accept: text/plain for the address followed by a newline; JSON is the default. Errors remain structured JSON in either format. With a VPN or proxy this is its exit address. A hosted caller observes its own connection, not a user device behind it. It does not discover local addresses or separately probe both address families. The Cloudflare deployment reads edge-provided connection headers, including preserved IPv6 when Pseudo IPv4 overwrites headers. Results and errors are not cached; the application does not store or log the returned IP address.'
      security: []
      responses:
        '200':
          description: The observed address as JSON with its address family, or as plain text when requested.
          headers:
            Cache-Control:
              description: Do not store this per-request result.
              schema:
                type: string
                const: no-store
            Vary:
              description: The response format depends on the Accept header.
              schema:
                type: string
                const: Accept
          content:
            application/json:
              examples:
                example1:
                  summary: IPv4
                  value:
                    ip: 203.0.113.1
                    family: ipv4
                example2:
                  summary: IPv6
                  value:
                    ip: 2001:db8::1
                    family: ipv6
              schema:
                $ref: '#/components/schemas/PublicIpResult'
            text/plain:
              examples:
                ipv4:
                  value: '203.0.113.1

                    '
                ipv6:
                  value: '2001:db8::1

                    '
              schema:
                type: string
                description: One IPv4 or IPv6 address followed by a newline.
        '405':
          description: Method is not supported for this endpoint.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Unexpected internal failure.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: 'CLIENT_IP_UNAVAILABLE: edge connection information is missing or invalid. No guessed or caller-supplied forwarded address is returned.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
              - INVALID_INPUT
              - MIXED_ADDRESS_FAMILIES
              - INVALID_JSON
              - PAYLOAD_TOO_LARGE
              - UNSUPPORTED_MEDIA_TYPE
              - NOT_FOUND
              - METHOD_NOT_ALLOWED
              - INTERNAL_ERROR
              - CLIENT_IP_UNAVAILABLE
              - NETWORK_ERROR
              - INVALID_RESPONSE
            message:
              type: string
            issues:
              type: array
              items:
                type: object
                properties:
                  index:
                    type: integer
                    minimum: 0
                    description: Zero-based index in inputs, or in the identified include/exclude list.
                  list:
                    type: string
                    minLength: 1
                    description: The input list containing the invalid entry. Existing subtraction errors use include or exclude.
                  field:
                    type: string
                    minLength: 1
                    description: The input field containing the invalid value. Existing range errors use start or end.
                  path:
                    type: array
                    items:
                      anyOf:
                      - type: string
                        minLength: 1
                      - type: integer
                        minimum: 0
                    description: Input field names and zero-based array indices, from the request root. An empty path identifies the whole request. Takes precedence over legacy field, list, and index locations.
                  message:
                    type: string
                  location:
                    type: object
                    properties:
                      line:
                        type: integer
                        minimum: 1
                      offset:
                        type: integer
                        minimum: 0
                      end:
                        type: integer
                        minimum: 0
                    required:
                    - line
                    - offset
                    - end
                    additionalProperties: false
                    description: 'Original text location: one-based line and zero-based UTF-16 start/end offsets. Certificate PEM errors use this to identify rejected material without echoing it.'
                required:
                - message
                additionalProperties: false
          required:
          - code
          - message
          additionalProperties: false
      required:
      - error
      additionalProperties: false
    PublicIpResult:
      oneOf:
      - type: object
        properties:
          family:
            type: string
            enum:
            - ipv4
          ip:
            type: string
            format: ip
        required:
        - family
        - ip
        additionalProperties: false
      - type: object
        properties:
          family:
            type: string
            enum:
            - ipv6
          ip:
            type: string
            format: ip
        required:
        - family
        - ip
        additionalProperties: false
      description: The IP address observed for this request. A VPN, proxy, or hosted client can change whose exit address is observed. One request observes one address family.