{"uid":"cap_Lte29eL1FILjyn722Gzuh","slug":"17711-ip-blocklist-check-845f7954","name":"17711 IP Blocklist Check","description":"A fleet of independent, x402-payable microservices callable by AI agents.","url":"https://api.17711.xyz/registry/ip-blocklist/v1/ip-blocklist/check","method":"POST","headers":{},"bodySchema":{"type":"object","required":["ip"],"properties":{"ip":{"type":"string","description":"The IPv4 address to check, e.g. `\"1.2.3.4\"`."}}},"responseSchema":{"ip":"string","banned":false,"matches":[{"cidr":"string","source":"string"}]},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bcyxbt4f_QC4d42QU-L1w","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks a single IPv4 address against a merged index of major public IP blocklists (FireHOL, Spamhaus, Tor exit nodes, Feodo, Talos) and returns whether it is banned and which lists matched.","exampleAgentPrompt":"Can you check whether the IP address 203.0.113.47 is on any major public blocklists like Spamhaus, FireHOL, or Tor exit lists?","exampleUseCases":[{"title":"Block malicious signup traffic","prompt":"Before I create an account for this user, check if their IP 198.51.100.22 is on any major blocklists like Spamhaus or Feodo — I want to reject signups from flagged IPs."},{"title":"Investigate suspicious server connection","prompt":"Someone from IP 45.83.64.1 just tried to connect to our API — can you check if that address appears on FireHOL, Talos, or any Tor exit node list?"},{"title":"Email sender reputation screening","prompt":"I'm getting email from a server at IP 91.108.4.13 and I want to know if it's listed as a spam source on Spamhaus or any other public blocklist before I trust it."}],"resultDescription":"A JSON object containing the queried IP address, a boolean 'banned' field indicating whether the IP appears on any list, and a 'matches' array where each entry has the matching CIDR range and the name of the blocklist source that flagged it (e.g. FireHOL, Spamhaus, Tor-exit, Feodo, Talos). If the IP is clean, 'banned' is false and 'matches' is empty.","failureModes":["Invalid or malformed IPv4 address returns a validation error","IPv6 addresses are not supported and will fail","Free quota exhausted returns HTTP 402 with payment challenge requiring USDC payment via x402","Rate limiting if the shared free tier is exhausted","Network timeouts if upstream blocklist index is unavailable"],"whenToPreferThis":"Choose this endpoint when you need a fast, multi-source IP reputation check against well-known public blocklists (FireHOL, Spamhaus, Tor exit, Feodo, Talos) in a single call, without maintaining your own threat-feed subscriptions. It is priced per-call at $0.002 USDC via x402, making it suitable for on-demand spot-checks in agent workflows. Prefer it over building your own blocklist aggregation or calling each feed separately. Not ideal for bulk batch lookups or for IPv6 addresses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:35:26.692Z","isFirstParty":false}