# 2s.io IP Network Identity Resolver

> 2s.io IP Network Identity Resolver is a paid API for AI agents from 2s.io, paid per call via x402, $0.009/call, status unknown (last checked 2026-09-15).

Resolves an IPv4 or IPv6 address to its full network identity, combining ASN, AS holder, ISP/org, BGP announcement status, RIR allocation, and geo (country/city/coordinates/timezone) in a single call.

## Facts

- Endpoint: GET https://2s.io/api/net/ip-resolve
- Price: $0.009/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-ip-network-identity-resolver-010dd893
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Da6DOjf04z3nnrsHXW3Gu

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 2s-io-ip-network-identity-resolver-010dd893
```

Example prompt: Can you tell me who runs the network behind IP 185.220.101.42 — I need the ASN, the AS holder, whether it's currently announced in BGP, the ISP, and the country and city it's geolocated to, all in one shot?

## When to prefer this

Choose this endpoint when you need both BGP/ASN network identity AND geolocation for an IP in a single API call, avoiding the latency and complexity of joining a geo IP API with a separate BGP/ASN source. Prefer this over net.asn (which is AS-number-first) or geo.ip (which is geo-only) when your workflow starts from a raw IP address and needs the full 'who runs this network and where' picture — especially for network forensics, abuse triage, or fraud signal enrichment.

## Known failure modes

- Invalid or malformed IP address returns a 4xx error
- Private/reserved IP ranges (e.g. 192.168.x.x, 10.x.x.x) may not resolve to public AS info
- RIPEstat source degraded — routing/holder block may be missing with per-source status indicating failure
- Geo source degraded — location data may be absent while ASN data succeeds
- IPv6 address with no BGP announcement returns empty routing fields
- Payment not fulfilled results in 402 response blocking the lookup

## How this service works

Resolve a single IPv4/IPv6 address to its full network identity in one call: the Autonomous System number, the authoritative AS holder/operator (RIPEstat), the ISP + organization, whether the AS is currently announced, the RIR/IANA allocation block the AS sits in, and country/region/city + coordinates + timezone. One join that turns an IP into "who runs this network and where" -- the lookup network-forensics, abuse triage, and fraud agents otherwise stitch together from a geo API plus a separate BGP source. Composes geo IP data + RIPEstat (RIPE NCC, CC BY 4.0); the routing/holder block degrades independently, with per-source status returned. Distinct from net.asn (AS-number first) and geo.ip (geo only): this is IP-first and joins both.

## Output

Returns a unified record containing: the ASN, the authoritative AS holder name from RIPEstat, ISP and organization names, whether the AS is currently BGP-announced, the RIR/IANA allocation block, and geolocation data (country, region, city, coordinates, timezone). Per-source status flags are included so the agent knows if any sub-source (routing vs geo) degraded independently.

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "required": [
      "ip"
     ],
     "properties": {
      "ip": {
       "type": "string",
       "description": "IPv4 or IPv6 address, e.g. 8.8.8.8."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-ip-network-identity-resolver-010dd893/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)