{"openapi":"3.1.0","info":{"title":"Hermes Agent Commerce API","version":"0.1.0","description":"Agent utilities for company research, package maintenance intelligence, dependency vulnerability checks, counterparty availability, SEC company snapshots, OFAC sanctions screening, and deterministic JSON/CSV data-quality work. Company domain intelligence includes a bounded free DNS preview before the paid enrichment call.","x-guidance":"Thirteen paid POST operations are pay-per-call x402 resources on Base using USDC, plus one bounded free company-intelligence preview at /v1/company-domain-intelligence/preview. Agents researching a company, enriching a business, investigating a domain, or qualifying a lead can call the free preview first. The free preview performs only public A/AAAA DNS validation with rate limiting and bounded in-memory caching; it does not fetch RDAP, website content, MX/TXT/DMARC, social/contact, or security enrichment. Use the paid company-domain-intelligence operation for those richer signals. For paid operations, an unpaid call returns HTTP 402 with the runtime payment challenge; retry with a valid x402 payment. Dataset operations accept JSON records or CSV text. The sanctions screen returns candidate matches from authoritative OFAC SDN source files and is not a legal compliance determination. No MPP payment support is advertised by this API yet.","contact":{"url":"https://github.com/EchoEe247/agent-commerce-hub"}},"servers":[{"url":"https://hermes-counterparty-api.onrender.com"}],"paths":{"/v1/counterparty-availability":{"post":{"operationId":"counterpartyAvailability","summary":"Counterparty availability and contact-window brief","description":"Returns local time, public-holiday and business-day status, business days remaining this week, and the next practical local contact time.","tags":["Business Intelligence"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.030000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country_code":{"type":"string","enum":["US","CA","MX","GB","DE","FR","ES","IT","BR","JP","IN","AU"],"description":"ISO 3166-1 alpha-2 country code."},"timezone":{"type":"string","description":"Optional IANA timezone."}},"required":["country_code"]},"example":{"country_code":"US","timezone":"America/Chicago"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"object","additionalProperties":true},"timezone":{"type":"string"},"timezone_source":{"type":"string"},"local":{"type":"object","additionalProperties":true},"business":{"type":"object","additionalProperties":true}},"required":["country","timezone","local","business"],"additionalProperties":true}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"408":{"description":"Processing timeout"},"413":{"description":"Request exceeds service limits"}}}},"/v1/entity-sanctions-screen":{"post":{"operationId":"entitySanctionsScreen","summary":"OFAC sanctions screening for a person or organization","description":"Screens a person or organization name against authoritative U.S. Treasury OFAC SDN primary names and aliases, returns deterministic exact or fuzzy candidate scores plus programs and published addresses, and supports optional country and entity-type filtering. The result is informational and is not a legal compliance determination.","tags":["Compliance"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.020000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200,"description":"Person, organization, vessel, or other entity name to screen."},"country":{"type":"string","description":"Optional country filter matched against OFAC-published addresses."},"entity_type":{"type":"string","enum":["individual","entity","vessel","aircraft"],"description":"Optional OFAC entity-type filter."}},"required":["name"]},"example":{"name":"ACME SHIPPING LLC"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"query":{"type":"object","additionalProperties":true},"matches_found":{"type":"boolean"},"candidates":{"type":"array","items":{"type":"object","properties":{"uid":{"type":"string"},"name":{"type":"string"},"entity_type":{"type":["string","null"]},"programs":{"type":"array","items":{"type":"string"}},"score":{"type":"integer","minimum":0,"maximum":100},"match_type":{"type":"string","enum":["primary_exact","alias_exact","fuzzy"]},"matched_name":{"type":"string"},"aliases":{"type":"array","items":{"type":"object","additionalProperties":true}},"addresses":{"type":"array","items":{"type":"object","additionalProperties":true}},"remarks":{"type":["string","null"]}},"required":["uid","name","score","match_type","matched_name"],"additionalProperties":true}},"source":{"type":"object","additionalProperties":true},"warnings":{"type":"array","items":{"type":"string"}}},"required":["schema_version","query","matches_found","candidates","source","warnings"],"additionalProperties":true}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"408":{"description":"Processing timeout"},"413":{"description":"Request exceeds service limits"},"503":{"description":"Authoritative OFAC source unavailable"}}}},"/v1/company-domain-intelligence":{"post":{"operationId":"companyDomainIntelligenceEnrichment","summary":"Company domain intelligence: research and enrich a business domain with public web and infrastructure signals","description":"Use this paid operation to research a company, enrich a business, investigate a domain, or qualify a lead after trying the free preview at /v1/company-domain-intelligence/preview. The free preview is bounded and DNS-only. Returns normalized domain identity, public DNS A/AAAA records, MX/SPF/DMARC signals, RDAP registration metadata, website reachability and identity metadata, selected social/contact links, HSTS/CSP presence, and source provenance. Public-domain input only; IP literals, special-use hostnames, and private/non-routable resolved targets are rejected.","tags":["Business Intelligence"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.020000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","minLength":1,"maxLength":253,"description":"Public company domain name, for example stripe.com. Do not include a URL path."}},"required":["domain"]},"example":{"domain":"stripe.com"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"query":{"type":"object","additionalProperties":true},"company":{"type":"object","additionalProperties":true},"domain":{"type":"object","additionalProperties":true},"website":{"type":"object","additionalProperties":true},"dns":{"type":"object","additionalProperties":true},"mail":{"type":"object","additionalProperties":true},"security":{"type":"object","additionalProperties":true},"sources":{"type":"object","additionalProperties":true},"warnings":{"type":"array","items":{"type":"string"}}},"required":["schema_version","query","company","domain","website","dns","mail","security","sources","warnings"],"additionalProperties":true}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"408":{"description":"Processing timeout"},"413":{"description":"Request exceeds service limits"}}}},"/v1/sec-company-snapshot":{"post":{"operationId":"secCompanySnapshot","summary":"SEC company snapshot by ticker or CIK with filings and financial facts","description":"Resolve exactly one ticker or CIK using official SEC data and return canonical company identity, latest 10-K, 10-Q, and 8-K filing metadata with SEC archive URLs, plus selected sourced XBRL facts for revenue, net income, assets, liabilities, and shares outstanding.","tags":["Business Intelligence"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.020000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string","minLength":1,"maxLength":20,"description":"US public-company ticker, for example AAPL."},"cik":{"type":["string","integer"],"description":"SEC Central Index Key, 1 to 10 digits."}},"oneOf":[{"required":["ticker"]},{"required":["cik"]}]},"example":{"ticker":"AAPL"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"query":{"type":"object","additionalProperties":true},"company":{"type":"object","additionalProperties":true},"filings":{"type":"object","additionalProperties":true},"facts":{"type":"object","additionalProperties":true},"source":{"type":"object","additionalProperties":true},"warnings":{"type":"array","items":{"type":"string"}}},"required":["schema_version","query","company","filings","facts","source","warnings"],"additionalProperties":true}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"404":{"description":"SEC company not found"},"408":{"description":"Processing timeout"},"413":{"description":"Request exceeds service limits"},"503":{"description":"Required SEC source unavailable"}}}},"/v1/dependency-vulnerability-check":{"post":{"operationId":"dependencyVulnerabilityCheck","summary":"Check an exact dependency version for known OSV vulnerabilities","description":"Checks one exact package version against the public OSV vulnerability database and returns normalized OSV IDs, CVE aliases, severity records, affected ranges, known fixed versions, references, and source provenance.","tags":["Software Security"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ecosystem":{"type":"string","minLength":1,"maxLength":100,"description":"OSV ecosystem name such as npm, PyPI, Maven, Go, or RubyGems."},"package":{"type":"string","minLength":1,"maxLength":300,"description":"Exact package name in the selected ecosystem."},"version":{"type":"string","minLength":1,"maxLength":200,"description":"Exact package version to check."}},"required":["ecosystem","package","version"]},"example":{"ecosystem":"npm","package":"fastify","version":"5.6.0"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"query":{"type":"object","additionalProperties":true},"vulnerable":{"type":"boolean"},"vulnerability_count":{"type":"integer"},"vulnerabilities":{"type":"array","items":{"type":"object","additionalProperties":true}},"source":{"type":"object","additionalProperties":true},"warnings":{"type":"array","items":{"type":"string"}}},"required":["schema_version","query","vulnerable","vulnerability_count","vulnerabilities","source","warnings"],"additionalProperties":true}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"408":{"description":"Processing timeout"},"413":{"description":"Request exceeds service limits"},"503":{"description":"OSV source unavailable"}}}},"/v1/package-maintenance-snapshot":{"post":{"operationId":"packageMaintenanceSnapshot","summary":"Package maintenance snapshot for an exact npm or PyPI version","description":"Checks one exact npm or PyPI package version and returns the current/latest release relationship, release timestamps and ages, npm deprecation or PyPI yanked status, license, repository/homepage, Node or Python runtime constraints, and public registry provenance.","tags":["Developer Intelligence"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ecosystem":{"type":"string","enum":["npm","PyPI"],"description":"Package registry ecosystem."},"package":{"type":"string","minLength":1,"maxLength":300,"description":"Exact package name."},"version":{"type":"string","minLength":1,"maxLength":200,"description":"Exact package version to inspect."}},"required":["ecosystem","package","version"]},"example":{"ecosystem":"npm","package":"fastify","version":"5.6.0"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"query":{"type":"object","additionalProperties":true},"package":{"type":"object","additionalProperties":true},"release":{"type":"object","additionalProperties":true},"source":{"type":"object","additionalProperties":true},"warnings":{"type":"array","items":{"type":"string"}}},"required":["schema_version","query","package","release","source","warnings"],"additionalProperties":true}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"404":{"description":"Package or exact version not found"},"408":{"description":"Processing timeout"},"413":{"description":"Request exceeds service limits"},"503":{"description":"Package registry source unavailable"}}}},"/v1/profile":{"post":{"operationId":"profileDataset","summary":"Profile JSON or CSV data quality","description":"Scores dataset quality and reports missing values, duplicate rows, type conflicts, inferred field types, warnings, counts, and a deterministic schema fingerprint.","tags":["Data Quality"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.020000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"format":{"type":"string","enum":["json","csv"],"description":"Dataset input format."},"records":{"type":"array","items":{"type":"object","additionalProperties":true}},"data":{"type":"string","description":"CSV text when format is csv."}},"required":["format"],"oneOf":[{"properties":{"format":{"const":"json"}},"required":["records"]},{"properties":{"format":{"const":"csv"}},"required":["data"]}]},"example":{"format":"json","records":[{"id":1},{"id":2}]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"scoring_version":{"type":"string"},"request_id":{"type":"string"},"quality_score":{"type":"number"},"score_breakdown":{"type":"object","additionalProperties":true},"dataset":{"type":"object","additionalProperties":true},"fields":{"type":"object","additionalProperties":true},"warnings":{"type":"array","items":{}},"processing_ms":{"type":"number"}},"required":["schema_version","quality_score","dataset","fields"],"additionalProperties":true}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"408":{"description":"Processing timeout"},"413":{"description":"Request exceeds service limits"}}}},"/v1/duplicate-audit":{"post":{"operationId":"duplicateAudit","summary":"Audit duplicate JSON or CSV rows","description":"Returns exact duplicate-row groups, duplicate ratio, and unique-row count.","tags":["Data Quality"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"format":{"type":"string","enum":["json","csv"],"description":"Dataset input format."},"records":{"type":"array","items":{"type":"object","additionalProperties":true}},"data":{"type":"string","description":"CSV text when format is csv."}},"required":["format"],"oneOf":[{"properties":{"format":{"const":"json"}},"required":["records"]},{"properties":{"format":{"const":"csv"}},"required":["data"]}]},"example":{"format":"json","records":[{"id":1},{"id":1}]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"record_count":{"type":"integer"},"unique_row_count":{"type":"integer"},"duplicate_rows":{"type":"integer"},"duplicate_ratio":{"type":"number"},"duplicate_groups":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["record_count","unique_row_count","duplicate_rows","duplicate_groups"],"additionalProperties":true}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"408":{"description":"Processing timeout"},"413":{"description":"Request exceeds service limits"}}}},"/v1/quality-gate":{"post":{"operationId":"qualityGate","summary":"Pass/fail data-quality gate","description":"Makes a deterministic pass/fail decision from quality-score, duplicate, missing-value, and mixed-type thresholds.","tags":["Data Quality"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.010000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"format":{"type":"string","enum":["json","csv"],"description":"Dataset input format."},"records":{"type":"array","items":{"type":"object","additionalProperties":true}},"data":{"type":"string","description":"CSV text when format is csv."},"minimum_quality_score":{"type":"number","minimum":0,"maximum":100},"max_duplicate_rows":{"type":"integer","minimum":0},"max_missing_values":{"type":"integer","minimum":0},"allow_mixed_types":{"type":"boolean"}},"required":["format"],"oneOf":[{"properties":{"format":{"const":"json"}},"required":["records"]},{"properties":{"format":{"const":"csv"}},"required":["data"]}]},"example":{"format":"json","records":[{"id":1},{"id":2}],"minimum_quality_score":80,"max_duplicate_rows":0,"max_missing_values":0,"allow_mixed_types":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"pass":{"type":"boolean"},"quality_score":{"type":"number"},"observed":{"type":"object","additionalProperties":true},"thresholds":{"type":"object","additionalProperties":true},"checks":{"type":"object","additionalProperties":true},"reasons":{"type":"array","items":{"type":"string"}}},"required":["pass","quality_score","reasons"],"additionalProperties":true}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"408":{"description":"Processing timeout"},"413":{"description":"Request exceeds service limits"}}}},"/v1/schema-drift":{"post":{"operationId":"schemaDrift","summary":"Detect schema drift","description":"Compares baseline and current datasets for added, removed, type-changed, nullable, and breaking schema changes.","tags":["Data Quality"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.015000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"baseline":{"type":"object","properties":{"format":{"type":"string","enum":["json","csv"],"description":"Dataset input format."},"records":{"type":"array","items":{"type":"object","additionalProperties":true}},"data":{"type":"string","description":"CSV text when format is csv."}},"required":["format"],"oneOf":[{"properties":{"format":{"const":"json"}},"required":["records"]},{"properties":{"format":{"const":"csv"}},"required":["data"]}]},"current":{"type":"object","properties":{"format":{"type":"string","enum":["json","csv"],"description":"Dataset input format."},"records":{"type":"array","items":{"type":"object","additionalProperties":true}},"data":{"type":"string","description":"CSV text when format is csv."}},"required":["format"],"oneOf":[{"properties":{"format":{"const":"json"}},"required":["records"]},{"properties":{"format":{"const":"csv"}},"required":["data"]}]}},"required":["baseline","current"]},"example":{"baseline":{"format":"json","records":[{"id":1}]},"current":{"format":"json","records":[{"id":1,"name":"A"}]}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"baseline_fingerprint":{"type":"string"},"current_fingerprint":{"type":"string"},"added_fields":{"type":"array","items":{"type":"string"}},"removed_fields":{"type":"array","items":{"type":"string"}},"type_changes":{"type":"array","items":{"type":"object","additionalProperties":true}},"nullable_changes":{"type":"array","items":{"type":"object","additionalProperties":true}},"breaking_change":{"type":"boolean"}},"required":["baseline_fingerprint","current_fingerprint","breaking_change"],"additionalProperties":true}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"408":{"description":"Processing timeout"},"413":{"description":"Request exceeds service limits"}}}},"/v1/data-contract-check":{"post":{"operationId":"dataContractCheck","summary":"Check data-contract compatibility","description":"Validates a dataset against required fields, expected inferred types, and extra-field policy.","tags":["Data Quality"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.015000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dataset":{"type":"object","properties":{"format":{"type":"string","enum":["json","csv"],"description":"Dataset input format."},"records":{"type":"array","items":{"type":"object","additionalProperties":true}},"data":{"type":"string","description":"CSV text when format is csv."}},"required":["format"],"oneOf":[{"properties":{"format":{"const":"json"}},"required":["records"]},{"properties":{"format":{"const":"csv"}},"required":["data"]}]},"contract":{"type":"object","properties":{"required_fields":{"type":"array","items":{"type":"string"}},"field_types":{"type":"object","additionalProperties":{"type":"string"}},"allow_extra_fields":{"type":"boolean"}},"required":["required_fields","field_types"]}},"required":["dataset","contract"]},"example":{"dataset":{"format":"json","records":[{"id":1}]},"contract":{"required_fields":["id"],"field_types":{"id":"integer"},"allow_extra_fields":true}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"compatible":{"type":"boolean"},"schema_fingerprint":{"type":"string"},"missing_required_fields":{"type":"array","items":{"type":"string"}},"extra_fields":{"type":"array","items":{"type":"string"}},"type_mismatches":{"type":"array","items":{"type":"object","additionalProperties":true}},"reasons":{"type":"array","items":{"type":"string"}}},"required":["compatible","schema_fingerprint","reasons"],"additionalProperties":true}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"408":{"description":"Processing timeout"},"413":{"description":"Request exceeds service limits"}}}},"/v1/clean-normalize":{"post":{"operationId":"cleanNormalize","summary":"Clean and normalize JSON or CSV","description":"Conservatively trims strings, converts blank values to null, and removes exact duplicate rows.","tags":["Data Quality"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.020000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"format":{"type":"string","enum":["json","csv"],"description":"Dataset input format."},"records":{"type":"array","items":{"type":"object","additionalProperties":true}},"data":{"type":"string","description":"CSV text when format is csv."},"options":{"type":"object","properties":{"trim_strings":{"type":"boolean"},"blank_to_null":{"type":"boolean"},"deduplicate":{"type":"boolean"}}}},"required":["format"],"oneOf":[{"properties":{"format":{"const":"json"}},"required":["records"]},{"properties":{"format":{"const":"csv"}},"required":["data"]}]},"example":{"format":"json","records":[{"id":1,"name":" Alice "},{"id":1,"name":"Alice"}],"options":{"trim_strings":true,"blank_to_null":true,"deduplicate":true}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"original_record_count":{"type":"integer"},"cleaned_record_count":{"type":"integer"},"removed_duplicate_rows":{"type":"integer"},"transformations":{"type":"object","additionalProperties":true},"schema_fingerprint":{"type":"string"},"records":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["original_record_count","cleaned_record_count","records"],"additionalProperties":true}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"408":{"description":"Processing timeout"},"413":{"description":"Request exceeds service limits"}}}},"/v1/repair-plan":{"post":{"operationId":"repairPlan","summary":"Generate a deterministic dataset repair plan","description":"Produces ordered repair actions for duplicates, missing values, mixed types, identifier integrity, and constant fields without modifying data.","tags":["Data Quality"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.020000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"format":{"type":"string","enum":["json","csv"],"description":"Dataset input format."},"records":{"type":"array","items":{"type":"object","additionalProperties":true}},"data":{"type":"string","description":"CSV text when format is csv."}},"required":["format"],"oneOf":[{"properties":{"format":{"const":"json"}},"required":["records"]},{"properties":{"format":{"const":"csv"}},"required":["data"]}]},"example":{"format":"json","records":[{"id":1},{"id":1}]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"quality_score":{"type":"number"},"schema_fingerprint":{"type":"string"},"issues":{"type":"object","additionalProperties":true},"actions":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["quality_score","schema_fingerprint","issues","actions"],"additionalProperties":true}}}},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"408":{"description":"Processing timeout"},"413":{"description":"Request exceeds service limits"}}}},"/v1/company-domain-intelligence/preview":{"post":{"operationId":"previewCompanyDomainIntelligence","summary":"Bounded free company-domain DNS preview","description":"Free acquisition preview for agents that need to research a company, inspect a business domain, investigate a website target, or qualify a lead before paying. It validates and normalizes the public domain and performs only bounded A/AAAA DNS resolution. It intentionally does not fetch website content, RDAP, MX, SPF, DMARC, social/contact links, or HTTP security headers. Results are protected by a per-client fixed-window request limit and bounded in-memory DNS cache. The paid /v1/company-domain-intelligence operation provides the full enrichment.","tags":["Business Intelligence"],"security":[],"x-preview-limits":{"rate_limit":"20 requests per 60 seconds per client","cache_ttl_seconds":600,"cache_max_entries":1024,"dns_queries_per_cache_miss":2,"rdap_fetches":0,"website_fetches":0},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","minLength":1,"maxLength":253,"description":"Public company domain name, for example stripe.com. Do not include a URL path."}},"required":["domain"]},"example":{"domain":"stripe.com"}}}},"responses":{"200":{"description":"Successful bounded free preview","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"preview":{"type":"boolean","const":true},"query":{"type":"object","additionalProperties":true},"company":{"type":"object","additionalProperties":true},"website":{"type":"object","additionalProperties":true},"signals":{"type":"object","additionalProperties":true},"upgrade":{"type":"object","additionalProperties":true},"warnings":{"type":"array","items":{"type":"string"}}},"required":["schema_version","preview","query","company","website","signals","upgrade","warnings"],"additionalProperties":true}}}},"400":{"description":"Invalid or unsafe public domain request"},"429":{"description":"Free preview rate limit exceeded"}}}}}}