ISP / ASN Lookup API — /api/v1/ip/isp

Faster, narrower variant of `/ip/lookup` — returns only the network ownership data without geo.

• Method GET
• Path /api/v1/ip/isp
• Stability STABLE
• Version v2026-05-15
• Summary Short-form ASN / ISP / organization lookup for an IP.

Pass these as query-string parameters (or, where indicated, in the request headers). Required params marked required.

• ip (required) — string Target IPv4 or IPv6 address.

All successful responses follow the standard `{ success: true, data: {...} }` envelope. Notable fields on the data object for this endpoint:

• data.ip — string Queried IP.
• data.network — string CIDR block the IP belongs to.
• data.isp — string ISP name.
• data.organization — string Organization owning the block.
• data.asn.number — integer Autonomous System Number.
• data.asn.organization — string ASN's registered name.
• data.type — string `ISP`, `Hosting`, `Mobile`, `Corporate`.

Truncated but representative example for a real lookup:

{
  "success": true,
  "data": {
    "ip": "8.8.8.8",
    "network": "8.8.8.8/32",
    "isp": "Google",
    "organization": "Google",
    "asn": {
      "number": 15169,
      "organization": "GOOGLE"
    },
    "type": "ISP",
    "details": "Google is a regular ISP providing internet services."
  }
}

Errors return HTTP status codes paired with stable machine-readable codes. Match on the code field rather than the human-readable message.

• 400 INVALID_IP Not a valid IPv4 / IPv6 address.

Patterns we recommend when integrating this endpoint:

• Use this over `/ip/lookup` when you only need network ownership — 30–40% faster.