# Cheap Utilities IP Classifier

> Cheap Utilities IP Classifier is a paid API for AI agents from cheap-utilities.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Classifies an IPv4 or IPv6 address as public, private, loopback, link-local, CGNAT, or reserved, and returns its reverse-DNS hostname.

## Facts

- Endpoint: GET https://cheap-utilities.x402tookit.com/ip-classify?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cheap-utilities-ip-classifier-55dc3c34
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wCOr6nzT12IYfHQorpaf7

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability cheap-utilities-ip-classifier-55dc3c34
```

Example prompt: Can you classify the IP address 100.64.0.1 and tell me whether it's publicly routable or falls into a special range like CGNAT, and what its reverse DNS name is?

## When to prefer this

Choose this endpoint when you need a fast, inexpensive classification of a single IP address into standard network categories (public, private, loopback, CGNAT, link-local, reserved) along with reverse DNS resolution, without needing geolocation, ASN data, or threat intelligence. It is ideal for log enrichment, form validation, firewall policy decisions, or any workflow that needs to quickly determine whether an IP is externally routable.

## Known failure modes

- Missing or malformed 'ip' query parameter returns an error
- Invalid IP address string (e.g. hostname or non-IP text) returns a validation error
- IPv6 addresses in compressed or expanded form may behave differently depending on parser
- Reverse DNS lookup may return null if no PTR record exists
- Service degraded flag may indicate partial result quality

## How this service works

Classify an IPv4 or IPv6 address: public, private, loopback, link-local, CGNAT or reserved, plus reverse-DNS name.

## Output

Returns a structured object including the IP's classification category (public, private, loopback, link-local, CGNAT, or reserved), whether it is publicly routable, the IP version, its integer representation, a reverse DNS pointer if available, a plain-language summary and verdict, the reasons behind the classification, and metadata such as source and timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "ip"
     ],
     "properties": {
      "ip": {
       "type": "string",
       "description": "IPv4 or IPv6 address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "integer": {
       "type": [
        "null",
        "number"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "version": {
       "type": [
        "null",
        "number"
       ]
      },
      "category": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "expanded": {},
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "reversePointer": {
       "type": [
        "null",
        "string"
       ]
      },
      "publiclyRoutable": {
       "type": [
        "boolean",
        "null"
       ]
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cheap-utilities-ip-classifier-55dc3c34/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cheap-utilities.x402tookit.com](https://www.zero.xyz/host/cheap-utilities.x402tookit.com/llms.txt)
