Skip to content
Back to IPWhois.net API

Card snapshot

ipwhois.net · 2026-10-31 14:37:54 UTC · e2f4220709829742ff55c79f4165164b032c7638f6b24134d681ed38125b3f72

This is a frozen copy of the agent's agent-card.json as we observed it at the timestamp above. We capture a new snapshot every time the card's content hash changes. Useful for: forensic drift analysis, verifying downstream callers see the right version, reproducing routing decisions made historically.

{
  "protocolVersion": "0.3.0",
  "name": "IPWhois.net API",
  "description": "IP geolocation, ISP and ASN data, IP blacklist status and MAC vendor lookup over a REST API with one key. A free key gives 1,000 lookups a day per service.",
  "url": "https://ipwhois.net/api/v1",
  "preferredTransport": "HTTP+JSON",
  "version": "1.0.0",
  "provider": {
    "organization": "IPWhois.net",
    "url": "https://ipwhois.net"
  },
  "documentationUrl": "https://ipwhois.net/api-docs",
  "iconUrl": "https://ipwhois.net/favicon.ico",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "securitySchemes": {
    "apiKey": {
      "type": "apiKey",
      "in": "header",
      "name": "X-API-Key",
      "description": "Free key at https://ipwhois.net/account/api"
    }
  },
  "security": [
    {
      "apiKey": []
    }
  ],
  "defaultInputModes": [
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "ip-lookup",
      "name": "IP address lookup",
      "description": "Geolocation (country, region, city, postal code, coordinates, time zone), ISP, organisation, ASN, connection type and network detail of an IPv4 or IPv6 address. Paid plans add parent company, hostname, IP range, RPKI, speed, VPN/proxy/Tor/hosting flags, threat data and abuse contact.",
      "tags": [
        "ip",
        "geolocation",
        "asn",
        "isp",
        "whois",
        "vpn-detection"
      ],
      "examples": [
        "GET https://ipwhois.net/api/v1/ip/8.8.8.8",
        "Where is 1.1.1.1 located and who runs it?"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "ip-blacklist",
      "name": "IP blacklist check",
      "description": "Whether an IP address is listed on DNS blacklists (DNSBL/RBL); paid plans return the per-list detail.",
      "tags": [
        "blacklist",
        "dnsbl",
        "rbl",
        "spam",
        "email-deliverability"
      ],
      "examples": [
        "GET https://ipwhois.net/api/v1/blacklist/8.8.8.8"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "mac-lookup",
      "name": "MAC address vendor lookup",
      "description": "Vendor, country, IEEE block (MA-L, MA-M, MA-S) and flags (multicast, locally administered, randomized) of a MAC address or OUI; vendor search on paid plans.",
      "tags": [
        "mac",
        "oui",
        "vendor",
        "ieee"
      ],
      "examples": [
        "GET https://ipwhois.net/api/v1/mac/00:1A:2B:3C:4D:5E"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ],
  "additionalInterfaces": [
    {
      "url": "https://ipwhois.net/openapi.json",
      "transport": "OpenAPI"
    }
  ],
  "termsOfService": "https://ipwhois.net/terms-of-use",
  "privacyPolicy": "https://ipwhois.net/privacy-policy"
}