{"uid":"cap_D0U8JzXWilsnSYAxVi9yp","slug":"macaroon-network-domain-ssl-check-86512063","name":"Macaroon Network Domain SSL Check","description":"Part of the Domain Web Trust family: live TLS handshake against a domain's HTTPS port, useful for confirming a domain has a valid, current certificate before an agent interacts with a website or merchant. Reports certificate validity, issuer/subject, and validity window (including days until expiry). Performed via a real TLS connection at request time -- no third-party certificate-transparency dataset or resale-terms question.","url":"https://api.macaroonnetwork.com/execute/domain-ssl-check-v1","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object"},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WtKzcITicmfBe6IuOXQv9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs a live TLS handshake against a domain's HTTPS port to verify certificate validity, issuer, subject, and expiry window in real time.","exampleAgentPrompt":"Before my agent contacts checkout.acmeshop.com, can you do a live TLS handshake check to confirm it has a valid SSL certificate, who issued it, and how many days until it expires?","exampleUseCases":[{"title":"Pre-interaction merchant trust check","prompt":"Before placing an order on bestdeals-marketplace.com, verify that their SSL certificate is valid, check who issued it, and tell me how many days are left before it expires."},{"title":"E-commerce integration safety gate","prompt":"We're about to integrate with api.partnerpayments.io — can you do a real-time TLS check to confirm their certificate is current and valid before we start sending data?"},{"title":"Monitoring certificate expiry for owned domain","prompt":"Check if my site mybusiness.com has a valid SSL certificate right now and warn me if it's expiring within the next 30 days."}],"resultDescription":"Returns the result of a live TLS handshake including: whether the certificate is currently valid, the certificate issuer and subject, the validity window (not-before and not-after dates), and the number of days remaining until expiry.","failureModes":["Domain does not resolve or is unreachable — connection error returned","Domain has an expired certificate — validity flag set to false with expiry date","Domain has a self-signed or untrusted certificate — issuer flagged accordingly","Port 443 is closed or filtered — TLS handshake fails with timeout or connection refused","Invalid domain input format — request rejected with validation error"],"whenToPreferThis":"Choose this endpoint when you need a real-time, live TLS handshake result rather than cached or third-party certificate-transparency data. It is ideal for pre-interaction trust checks on merchants, partners, or any web service where certificate freshness and authenticity matter. Prefer it over passive CT log lookups when you need to confirm the certificate is actively being served right now.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:50:11.434Z","isFirstParty":false}