{"uid":"cap_B00eGkz1hO4cjAOdj1y7B","slug":"brainiac-certificate-expiry-inventory-fea9b7b5","name":"BRAINIAC Certificate Expiry Inventory","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/certificate-expiry-inventory?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":"C1","host":"www.example.com","issuer":"Example CA","source":"Caller-supplied inventory","status":"expiring_soon","notAfter":"2026-12-01T00:00:00.000Z","notBefore":"2025-01-01T00:00:00.000Z","commonName":"www.example.com","serialNumber":"","daysRemaining":26.125,"fingerprintSha256":"","daysRemainingSupplied":true,"privateNetworkScanned":false},{"id":"C2","host":"legacy.example.com","issuer":"Example CA","source":"Caller-supplied inventory","status":"expired","notAfter":"2026-10-15T00:00:00.000Z","notBefore":"2024-01-01T00:00:00.000Z","commonName":"legacy.example.com","serialNumber":"","daysRemaining":-20.875,"fingerprintSha256":"","daysRemainingSupplied":true,"privateNetworkScanned":false}],"status":"inventoried","findings":[{"code":"cert_status","kind":"conflict","detail":"Certificate is expiring_soon (26.125 days from asOf).","subject":"C1"},{"code":"cert_status","kind":"conflict","detail":"Certificate is expired (-20.875 days from asOf).","subject":"C2"}],"checkedAt":"2026-11-04T21:00:00.000Z","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."],"expiredCount":1,"apiKeyRequired":false,"certificateCount":2,"paidProviderUsed":false,"publicDnsQueried":false,"expiringSoonCount":1,"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_C_bR-GLE2hJGhQ9dWQoVh","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":"Analyzes a supplied list of TLS/SSL certificates and reports their expiry status, days remaining, and compliance findings for each host.","exampleAgentPrompt":"I have a CSV list of our TLS certificates with their hostnames and expiry dates — can you analyze it and tell me which ones are already expired or expiring within the next 30 days, as of today?","exampleUseCases":[{"title":"Pre-audit certificate compliance sweep","prompt":"Before our security audit next week, can you go through this JSON list of our production certificates and flag any that are expired or expiring within 60 days? Use today's date as the reference point."},{"title":"Automated renewal alert triage","prompt":"Here's a CSV export from our certificate manager with all our domains and their notAfter dates — analyze it and give me a breakdown of how many are expired, expiring soon, and healthy so I know what to prioritize for renewal."},{"title":"Post-migration certificate health check","prompt":"We just migrated 50 hosts to new infrastructure. I have a list of the new certs in JSON format — can you inventory them and confirm none are already expired or dangerously close to expiry, as of November 1 2025?"}],"resultDescription":"Returns a structured inventory of each certificate with its status (expired, expiring_soon, valid), days remaining, issuer, common name, notAfter/notBefore dates, and a findings array flagging compliance issues. Also returns aggregate counts (expiredCount, expiringSoonCount, certificateCount) and metadata about whether public TLS inspection or DNS was used.","failureModes":["Malformed or unrecognized CSV/JSON input returns parsing errors","Missing or ambiguous notAfter dates result in items being unclassifiable","Very large inventories (>10,000 items) may be truncated or rejected","If asOf date is not parseable, the analysis reference date may default to current time or fail","No network scanning is performed, so live certificate state is not verified — only supplied data is analyzed"],"whenToPreferThis":"Use this endpoint when you have a pre-existing inventory of certificates (from a certificate manager, CMDB, or log export) and need to classify their expiry status in bulk without performing live network scans. Ideal for compliance reporting, renewal prioritization, and audit preparation where you control the input data. Prefer alternatives if you need live TLS handshake verification or active scanning of hosts you haven't yet enumerated.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:54.336Z","isFirstParty":false,"canonicalSlug":"brainiac-certificate-expiry-inventory-fea9b7b5"}