{"uid":"cap_Vf994K_5HTAWr9j9IzBOo","slug":"brainiac-ip-address-reputation-check-95d290a9","name":"BRAINIAC IP Address Reputation Check","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/network-intelligence/ip-address-reputation-check?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":200000},"asOf":{"type":"string","maxLength":40},"file":{"type":"object","required":["fileBase64"],"properties":{"role":{"type":"string","maxLength":80},"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/plain","text/csv","application/json","application/octet-stream"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"json":{"type":"string","maxLength":200000},"logs":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"host":{"type":"string","maxLength":253},"source":{"type":"string","maxLength":200},"message":{"type":"string","maxLength":4000},"facility":{"type":"string","maxLength":80},"severity":{"type":"string","maxLength":40},"sourceIp":{"type":"string","maxLength":80},"destinationIp":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":10000},"text":{"type":"string","maxLength":200000},"files":{"type":"array","items":{"type":"object","required":["fileBase64"],"properties":{"role":{"type":"string","maxLength":80},"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/plain","text/csv","application/json","application/octet-stream"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"maxItems":20},"configs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"key":{"type":"string","maxLength":200},"path":{"type":"string","maxLength":200},"side":{"enum":["left","right","before","after","a","b"],"type":"string"},"value":{"type":"string","maxLength":4000},"source":{"type":"string","maxLength":200},"deviceId":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":10000},"bgpRoutes":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"peer":{"type":"string","maxLength":80},"side":{"enum":["before","after","left","right","a","b"],"type":"string"},"asPath":{"type":"string","maxLength":500},"prefix":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"nextHop":{"type":"string","maxLength":80},"originAs":{"type":"string","maxLength":40}},"additionalProperties":false},"maxItems":5000},"incidents":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"host":{"type":"string","maxLength":253},"title":{"type":"string","maxLength":200},"detail":{"type":"string","maxLength":2000},"source":{"type":"string","maxLength":200},"severity":{"type":"string","maxLength":40}},"additionalProperties":false},"maxItems":5000},"publicDns":{"type":"object","required":["hostname"],"properties":{"hostname":{"type":"string","maxLength":253,"minLength":1},"recordType":{"enum":["A","AAAA","CNAME","MX","TXT","NS"],"type":"string"}},"additionalProperties":false},"publicTls":{"type":"object","required":["host"],"properties":{"host":{"type":"string","maxLength":253,"minLength":1}},"additionalProperties":false},"dnsRecords":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"rcode":{"type":"string","maxLength":40},"answer":{"type":"string","maxLength":500},"source":{"type":"string","maxLength":200},"hostname":{"type":"string","maxLength":253},"resolver":{"type":"string","maxLength":80},"latencyMs":{"type":"number","maximum":1000000,"minimum":0},"recordType":{"enum":["A","AAAA","CNAME","MX","TXT","NS","SOA"],"type":"string"},"expectedAnswer":{"type":"string","maxLength":500}},"additionalProperties":false},"maxItems":5000},"reputations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"ip":{"type":"string","maxLength":80},"score":{"type":"number","maximum":100,"minimum":0},"listed":{"type":"boolean"},"source":{"type":"string","maxLength":200},"category":{"type":"string","maxLength":120},"hostname":{"type":"string","maxLength":253},"listName":{"type":"string","maxLength":120},"observedAt":{"type":"string","maxLength":40}},"additionalProperties":false},"maxItems":5000},"certificates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"host":{"type":"string","maxLength":253},"issuer":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200},"notAfter":{"type":"string","maxLength":40},"notBefore":{"type":"string","maxLength":40},"commonName":{"type":"string","maxLength":253},"serialNumber":{"type":"string","maxLength":120},"fingerprintSha256":{"type":"string","maxLength":120}},"additionalProperties":false},"maxItems":2000},"latencySamples":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"host":{"type":"string","maxLength":253},"pathId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"latencyMs":{"type":"number","maximum":1000000,"minimum":0}},"additionalProperties":false},"maxItems":10000},"latencyAnomalyZ":{"type":"number","maximum":10,"minimum":1},"expiryWarningDays":{"type":"number","maximum":3650,"minimum":0},"packetLossSamples":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"host":{"type":"string","maxLength":253},"lost":{"type":"number","maximum":1000000000,"minimum":0},"sent":{"type":"number","maximum":1000000000,"minimum":0},"pathId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"lossPct":{"type":"number","maximum":100,"minimum":0}},"additionalProperties":false},"maxItems":10000},"packetLossWarnPct":{"type":"number","maximum":100,"minimum":0}}},"responseSchema":{"type":"json","example":{"items":[{"id":"R1","ip":"198.51.100.50","risky":false,"score":10,"listed":false,"source":"Caller-supplied","category":"","hostname":"","listName":"Caller blocklist export","observedAt":"2026-11-04T12:00:00.000Z","scoreSupplied":true,"listedSupplied":true,"paidReputationApiUsed":false,"privateNetworkScanned":false},{"id":"R2","ip":"203.0.113.77","risky":true,"score":85,"listed":true,"source":"Caller-supplied","category":"spam","hostname":"","listName":"Caller blocklist export","observedAt":"2026-11-04T12:00:00.000Z","scoreSupplied":true,"listedSupplied":true,"paidReputationApiUsed":false,"privateNetworkScanned":false}],"status":"checked","findings":[{"code":"private_reputation_ip","kind":"observation","detail":"IP is private/special; retained from caller data only and not queried against any reputation service.","subject":"R1"},{"code":"private_reputation_ip","kind":"observation","detail":"IP is private/special; retained from caller data only and not queried against any reputation service.","subject":"R2"},{"code":"reputation_listed","kind":"conflict","detail":"Caller-supplied reputation signal indicates risk (listed=true, score=85).","subject":"R2"}],"checkedAt":"2026-11-04T21:00:00.000Z","riskyCount":1,"limitations":["Network logs, latency/packet-loss samples, DNS answers, BGP routes, certificates, configs, reputation labels, and incidents are copied only from labeled fields supplied by the caller, or from optional key-free public DNS / public TLS port-443 inspection when explicitly requested.","Private, loopback, link-local, and documentation addresses are never contacted. Private networks are not scanned.","No intrusive security testing is performed and no paid reputation API is used.","IP reputation uses only caller-supplied labels/observations. Missing reputation data is not invented.","Infrastructure health reports aggregate only sections for which records were supplied or optionally fetched."],"subjectCount":2,"apiKeyRequired":false,"paidProviderUsed":false,"publicDnsQueried":false,"publicTlsInspected":false,"paidReputationApiUsed":false,"privateNetworkScanned":false,"intrusiveScanPerformed":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BqgO3eVXRt1raopbIXkL5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks one or more IP addresses for reputation risk, returning threat scores, blocklist status, category tags, and enriched findings via pay-per-call x402 on Base.","exampleAgentPrompt":"Can you check the reputation of these IPs — 198.51.100.50 and 203.0.113.77 — and tell me if either is risky, what threat category they fall under, and their scores?","exampleUseCases":[{"title":"Firewall decision on inbound IPs","prompt":"I have a list of IPs hitting my API gateway right now — 203.0.113.77, 198.51.100.50, and 192.0.2.44 — can you check their reputation scores and tell me which ones are risky or on any blocklists so I can decide whether to block them?"},{"title":"Security triage from server logs","prompt":"I exported server logs with these source IPs and I want to know which ones are flagged as spam, malware, or other threats — can you run a reputation check and give me a risk summary with scores for each one?"},{"title":"Pre-connection IP vetting for data pipeline","prompt":"Before I let this batch of external data sources connect, can you check the reputation of their IP addresses and flag any that have a high risk score or are listed on blocklists?"}],"resultDescription":"Returns a JSON array of reputation results per IP, each with: a risk flag (risky: true/false), a numeric score (0-100), blocklist membership (listed: true/false), threat category, resolved hostname, observed timestamp, and the source of the reputation data. Also includes a findings array with coded observations or conflicts, aggregate counts (riskyCount, subjectCount), a checkedAt timestamp, and a limitations list clarifying which data sources were used vs. omitted.","failureModes":["Private or reserved IP ranges (loopback, link-local, documentation) are not queried against reputation services — only caller-supplied labels are retained","No paid external reputation API is called; if caller supplies no labels for an IP, reputation data will be absent","Malformed IP addresses in input may be skipped or flagged in findings","Overly large batches may hit maxItems limits (10,000 log entries)","Missing required fields in log objects may result in those records being ignored"],"whenToPreferThis":"Prefer this endpoint when you need a no-account, pay-per-call IP reputation check with a fixed $0.03 USDC cost settled on Base via x402 — ideal for AI agents that need autonomous operation without API key management. Best suited for security triage, firewall decisions, and log analysis where caller-supplied reputation labels or raw log data with IP fields are available. If you need deep real-time threat feeds from commercial threat intelligence providers, a dedicated threat intel platform may offer broader coverage.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:58.245Z","isFirstParty":false,"canonicalSlug":"brainiac-ip-address-reputation-check-95d290a9"}