{"openapi":"3.1.0","info":{"title":"Live Entity Verification API","description":"Cross-signal Bayesian corroboration of entity existence. Combines WHOIS, Certificate Transparency, Wayback Machine, and DNS operational maturity into a calibrated hallucination verdict.","version":"1.0.0","contact":{"email":"dasaanrod@gmail.com"}},"paths":{"/verify-entity-existence-cross-signal":{"post":{"summary":"Verify Entity Existence Cross Signal","description":"Fuses WHOIS, CT, Wayback, and DNS signals with Bayesian calibrated weights.\nReturns corroborated existence verdict, hallucination probability, and\nfailure mode classification. Fail-closed: insufficient corroboration\nreturns a blocking verdict rather than an ambiguous null.","operationId":"verify_entity_existence_cross_signal_verify_entity_existence_cross_signal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyEntityRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Verify Entity Existence Cross Signal Verify Entity Existence Cross Signal Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/resolve-whois-registration-timeline":{"post":{"summary":"Resolve Whois Registration Timeline","description":"Resolves WHOIS registration timeline. Returns creation, expiration,\nupdated dates, registrar, registrant country, age in days, and\nhistorical registrant count where available.","operationId":"resolve_whois_registration_timeline_resolve_whois_registration_timeline_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WhoisRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Resolve Whois Registration Timeline Resolve Whois Registration Timeline Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/probe-certificate-transparency-presence":{"post":{"summary":"Probe Certificate Transparency Presence","description":"Searches crt.sh CT logs for certificates issued for a domain.\nComputes certificate count, issuance date range, unique issuers,\nsubdomain count, and continuity score.","operationId":"probe_certificate_transparency_presence_probe_certificate_transparency_presence_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CTRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Probe Certificate Transparency Presence Probe Certificate Transparency Presence Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]}}},"/measure-wayback-snapshot-density":{"post":{"summary":"Measure Wayback Snapshot Density","description":"Measures Wayback Machine CDX snapshot density over a lookback window.\nReturns total snapshots, first/last dates, snapshots per year,\ndensity score, and coverage gaps in months.","operationId":"measure_wayback_snapshot_density_measure_wayback_snapshot_density_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaybackRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Measure Wayback Snapshot Density Measure Wayback Snapshot Density Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]}}},"/audit-dns-operational-maturity":{"post":{"summary":"Audit Dns Operational Maturity","description":"Audits DNS operational maturity: MX, SPF, DMARC, DKIM selectors,\nNS record count, and propagation consistency across resolvers.\nReturns maturity score and component signals. DNS maturity alone\nis not sufficient for VERIFIED_LIVE verdict per cross-signal spec.","operationId":"audit_dns_operational_maturity_audit_dns_operational_maturity_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DNSRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Audit Dns Operational Maturity Audit Dns Operational Maturity Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]}}},"/stripe/webhook":{"post":{"summary":" Nexus Stripe Webhook","operationId":"_nexus_stripe_webhook_stripe_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"CTRequest":{"properties":{"domain":{"type":"string","maxLength":253,"minLength":3,"title":"Domain","description":"Fully qualified domain name, e.g. 'acme-corp.com'."},"include_subdomains":{"type":"boolean","title":"Include Subdomains","description":"When true, includes certificates issued to subdomains.","default":false},"max_certs_to_analyze":{"type":"number","maximum":1000.0,"minimum":1.0,"title":"Max Certs To Analyze","description":"Maximum number of certificate records to analyze from CT logs.","default":100}},"type":"object","required":["domain"],"title":"CTRequest"},"DNSRequest":{"properties":{"domain":{"type":"string","maxLength":253,"minLength":3,"title":"Domain","description":"Fully qualified domain name, e.g. 'acme-corp.com'."},"resolvers":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":5,"minItems":1},{"type":"null"}],"title":"Resolvers","description":"Optional list of DNS resolver IPs. Defaults to ['8.8.8.8','1.1.1.1']."}},"type":"object","required":["domain"],"title":"DNSRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VerifyEntityRequest":{"properties":{"domain":{"type":"string","maxLength":253,"minLength":3,"title":"Domain","description":"Fully qualified domain name, e.g. 'acme-corp.com'."},"entity_name":{"type":"string","maxLength":200,"minLength":1,"title":"Entity Name","description":"Human-readable entity name the domain is supposed to represent."},"min_confidence_threshold":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Min Confidence Threshold","description":"Minimum verdict_confidence for a decisive verdict.","default":0.65},"signal_mask":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":4,"minItems":1},{"type":"null"}],"title":"Signal Mask","description":"Subset of signals to evaluate. Null means all four are evaluated."}},"type":"object","required":["domain","entity_name"],"title":"VerifyEntityRequest"},"WaybackRequest":{"properties":{"domain":{"type":"string","maxLength":253,"minLength":3,"title":"Domain","description":"Fully qualified domain name, e.g. 'acme-corp.com'."},"lookback_years":{"type":"number","maximum":30.0,"minimum":1.0,"title":"Lookback Years","description":"Number of years back from now to analyze snapshot density.","default":5}},"type":"object","required":["domain"],"title":"WaybackRequest"},"WhoisRequest":{"properties":{"domain":{"type":"string","maxLength":253,"minLength":3,"title":"Domain","description":"Fully qualified domain name, e.g. 'acme-corp.com'."},"include_historical_registrants":{"type":"boolean","title":"Include Historical Registrants","description":"When true, resolves historical registrant records where available.","default":false}},"type":"object","required":["domain"],"title":"WhoisRequest"}}}}