@apifreaks/openapi-specs 0.3.2 → 0.4.1

package/dist/index.cjs

@@ -27,7 +27,6 @@ __export(index_exports, {
   SPEC_SLUGS: () => SPEC_SLUGS,
   SpecCategory: () => SpecCategory,
   SpecSlug: () => SpecSlug,
-  getSpec: () => getSpec,
   getSpecJson: () => getSpecJson,
   getSpecYaml: () => getSpecYaml,
   getSpecsByCategory: () => getSpecsByCategory
@@ -7029,6 +7028,1123 @@ var bulk_domain_checker_default = {
   ]
 };
 
+// specs/domain/domain-reputation.json
+var domain_reputation_default = {
+  openapi: "3.1.1",
+  info: {
+    title: "Domain Reputation API - Real-Time Risk Verdict, Trust Score, DGA Detection, and Threat Intelligence for Any Domain",
+    version: "1.0.0",
+    description: "Assess any domain and get a synthesized risk verdict, a weighted trust score, DGA detection, threat intelligence matches, and a full email deliverability check in one call. Every score carries the evidence behind it, and partial data is called out in errors rather than silently dropped. Built for fraud screening, phishing triage, email vetting, brand protection, and threat intel enrichment.",
+    contact: {
+      name: "APIFreaks Support",
+      url: "https://apifreaks.com/contact",
+      email: "support@apifreaks.com"
+    }
+  },
+  servers: [
+    {
+      url: "https://api.apifreaks.com/v1.0",
+      description: "Domain Reputation API Server"
+    }
+  ],
+  paths: {
+    "/domain/reputation": {
+      get: {
+        tags: ["Domain APIs"],
+        summary: "Get a real-time risk verdict, trust score, and threat intelligence for any domain.",
+        description: "The Domain Reputation API assesses a domain and returns a risk verdict, trust score, DGA detection results, threat intelligence matches, email deliverability analysis, and evidence summary. Partial data is flagged in the errors array rather than silently dropped.",
+        parameters: [
+          {
+            name: "format",
+            in: "query",
+            required: false,
+            schema: {
+              type: "string",
+              enum: ["json", "xml"],
+              default: "json"
+            },
+            description: "Format of the response."
+          },
+          {
+            name: "domainName",
+            in: "query",
+            required: true,
+            schema: {
+              type: "string"
+            },
+            description: "The domain name to assess (e.g. example.com). Must contain at least one dot and be at most 253 characters. Automatically lowercased."
+          }
+        ],
+        responses: {
+          "200": {
+            description: "Success",
+            content: {
+              "application/json": {
+                schema: {
+                  $ref: "#/components/schemas/DomainReputationResponse"
+                },
+                examples: {
+                  success: {
+                    summary: "Safe domain (apple.com)",
+                    value: {
+                      input: {
+                        domain: "apple.com"
+                      },
+                      assessed_at: "2026-09-08T08:36:23.820181075Z",
+                      version: "1.0.0",
+                      processing_time_ms: 1739,
+                      risk_category: {
+                        verdict: "safe",
+                        confidence: 0.8,
+                        primary_threat: null,
+                        severity: "none",
+                        threat_types: [],
+                        sources: [],
+                        pivot_matches: []
+                      },
+                      dga_score: {
+                        score: 0,
+                        is_dga: false,
+                        model: "deterministic_features_v1",
+                        features: {
+                          domain_length: 5,
+                          vowel_consonant_ratio: 0.6666666666666666,
+                          ngram_perplexity: -8.83,
+                          shannon_entropy: 1.9219280948873623,
+                          digit_letter_ratio: 0,
+                          consonant_streak_max: 3,
+                          tld_in_known_dga_set: false
+                        },
+                        interpretation: "human_readable"
+                      },
+                      trust_signals: {
+                        trust_score: 72,
+                        trust_band: "high",
+                        signals: {
+                          positive: [
+                            {
+                              code: "spf_configured",
+                              weight: 5,
+                              polarity: "positive",
+                              category: "email_security",
+                              evidence: "SPF record found",
+                              confidence: 1
+                            },
+                            {
+                              code: "dmarc_present",
+                              weight: 5,
+                              polarity: "positive",
+                              category: "email_security",
+                              evidence: "DMARC record present",
+                              confidence: 1
+                            },
+                            {
+                              code: "established_domain",
+                              weight: 10,
+                              polarity: "positive",
+                              category: "domain_age",
+                              evidence: "Domain age > 2 years",
+                              confidence: 1
+                            },
+                            {
+                              code: "mature_domain",
+                              weight: 5,
+                              polarity: "positive",
+                              category: "domain_age",
+                              evidence: "Domain age > 5 years",
+                              confidence: 1
+                            },
+                            {
+                              code: "paid_ssl",
+                              weight: 5,
+                              polarity: "positive",
+                              category: "ssl_certificate",
+                              evidence: "Uses paid SSL certificate",
+                              confidence: 0.9
+                            },
+                            {
+                              code: "valid_ssl",
+                              weight: 3,
+                              polarity: "positive",
+                              category: "ssl_certificate",
+                              evidence: "Valid SSL certificate",
+                              confidence: 1
+                            }
+                          ],
+                          negative: [
+                            {
+                              code: "privacy_whois",
+                              weight: 1,
+                              polarity: "negative",
+                              category: "whois_privacy",
+                              evidence: "WHOIS information is privacy-protected",
+                              confidence: 0.9
+                            },
+                            {
+                              code: "external_redirect",
+                              weight: 10,
+                              polarity: "negative",
+                              category: "content_analysis",
+                              evidence: "Site redirects visitors to an external domain",
+                              confidence: 0.8
+                            }
+                          ],
+                          neutral: []
+                        },
+                        indicators: {
+                          is_newly_registered: false,
+                          uses_free_extension: false,
+                          uses_free_ssl: false,
+                          has_privacy_whois: true,
+                          ssl_age_days: 26,
+                          has_dmarc: true,
+                          has_spf: true,
+                          redirects_externally: true,
+                          javascript_obfuscated: false,
+                          domain_age_days: 14446,
+                          registrar: "NOM-IQ Ltd dba Com Laude"
+                        }
+                      },
+                      email_deliverability: {
+                        score: 95,
+                        grade: "excellent",
+                        can_receive_email: true,
+                        authentication: {
+                          spf: {
+                            present: true,
+                            policy: "~all",
+                            record: "v=spf1 include:_spf.apple.com include:_spf-txn.apple.com ~all"
+                          },
+                          dkim: {
+                            found: true,
+                            selectors_found: ["selector1", "selector2"],
+                            providers_detected: [],
+                            note: "Only common selectors are probed; a domain may use a custom selector"
+                          },
+                          dmarc: {
+                            present: true,
+                            policy: "quarantine",
+                            reporting_configured: true
+                          }
+                        },
+                        infrastructure: {
+                          mx_count: 6,
+                          mx_records: [
+                            "mx-in-ma.apple.com.",
+                            "mx-in.g.apple.com.",
+                            "mx-in-rn.apple.com.",
+                            "mx-in-sg.apple.com.",
+                            "mx-in-hfd.apple.com.",
+                            "mx-in-vib.apple.com."
+                          ],
+                          mx_provider: "self_hosted",
+                          null_mx: false
+                        },
+                        reputation: {
+                          spam_blacklisted: false,
+                          newly_registered: false,
+                          domain_age_days: 14446
+                        },
+                        issues: [
+                          {
+                            code: "spf_softfail",
+                            severity: "low",
+                            message: "The SPF policy '~all' only soft-fails unauthorized senders",
+                            recommendation: "Move to '-all' once all legitimate sending sources are listed"
+                          }
+                        ]
+                      },
+                      intelligence: {
+                        ioc_type: "domain",
+                        ioc_value: "apple.com",
+                        related_iocs: [
+                          {
+                            type: "ipv4",
+                            value: "17.253.144.10",
+                            confidence: 0.9
+                          },
+                          {
+                            type: "ipv6",
+                            value: "2620:149:af0:0:0:0:0:10",
+                            confidence: 0.9
+                          }
+                        ],
+                        feed_tags: [
+                          "verdict:safe",
+                          "severity:none",
+                          "ns:d.ns.apple.com.",
+                          "ns:b.ns.apple.com.",
+                          "ns:c.ns.apple.com.",
+                          "ns:a.ns.apple.com.",
+                          "mx:mx-in-ma.apple.com.",
+                          "mx:mx-in.g.apple.com.",
+                          "mx:mx-in-rn.apple.com.",
+                          "mx:mx-in-sg.apple.com.",
+                          "mx:mx-in-hfd.apple.com.",
+                          "mx:mx-in-vib.apple.com."
+                        ],
+                        stix_pattern: "[domain-name:value = 'apple.com' OR ipv4-addr:value = '17.253.144.10' OR ipv6-addr:value = '2620:149:af0:0:0:0:0:10']",
+                        recommended_action: "allow",
+                        first_seen: null,
+                        last_seen: null
+                      },
+                      evidence_summary: {
+                        why_flagged: []
+                      },
+                      errors: []
+                    }
+                  },
+                  partialData: {
+                    summary: "Partial data (WHOIS lookup failed)",
+                    value: {
+                      input: {
+                        domain: "apifreaks.com"
+                      },
+                      risk_category: {
+                        verdict: "safe",
+                        confidence: 0.7,
+                        severity: "none"
+                      },
+                      trust_signals: {
+                        trust_score: 70,
+                        trust_band: "high",
+                        indicators: {
+                          is_newly_registered: null,
+                          has_privacy_whois: null,
+                          domain_age_days: null,
+                          registrar: null
+                        }
+                      },
+                      errors: ["WHOIS lookup failed"]
+                    }
+                  }
+                }
+              }
+            },
+            headers: {
+              "X-AF-Credits-Cost": {
+                $ref: "#/components/headers/X-AF-Credits-Cost"
+              }
+            }
+          },
+          "400": {
+            description: "Bad Request \u2013 Invalid or missing domainName parameter",
+            content: {
+              "application/json": {
+                schema: {
+                  $ref: "#/components/schemas/ErrorResponse"
+                },
+                examples: {
+                  invalidDomain: {
+                    summary: "Invalid domain parameter",
+                    value: {
+                      error: "Invalid Domain Exception",
+                      message: 'Please provide a valid domain name in the "domainName" parameter.',
+                      path: "/v1.0/domain/reputation",
+                      status: 400,
+                      timestamp: "2026-09-08T12:00:00.000Z"
+                    }
+                  },
+                  missingDomain: {
+                    summary: "Missing domainName parameter",
+                    value: {
+                      error: "Invalid Param Exception",
+                      message: 'Please provide a valid domain name in the "domainName" parameter.',
+                      path: "/v1.0/domain/reputation",
+                      status: 400,
+                      timestamp: "2026-09-08T12:00:00.000Z"
+                    }
+                  }
+                }
+              }
+            },
+            headers: {
+              "X-AF-Credits-Cost": {
+                $ref: "#/components/headers/X-AF-Credits-Cost"
+              }
+            }
+          },
+          "503": {
+            description: "Service Unavailable \u2013 The assessment service is temporarily unavailable",
+            content: {
+              "application/json": {
+                schema: {
+                  $ref: "#/components/schemas/ErrorResponse"
+                },
+                examples: {
+                  serviceUnavailable: {
+                    summary: "Service Unavailable",
+                    value: {
+                      error: "Service Unavailable",
+                      message: "Service is unavailable. Please try after some time. [For Technical Support email at: support@apifreaks.com]",
+                      path: "/v1.0/domain/reputation",
+                      status: 503,
+                      timestamp: "2026-09-08T12:00:00.000Z"
+                    }
+                  }
+                }
+              }
+            },
+            headers: {
+              "X-AF-Credits-Cost": {
+                $ref: "#/components/headers/X-AF-Credits-Cost"
+              }
+            }
+          }
+        },
+        operationId: "getDomainReputation"
+      }
+    }
+  },
+  components: {
+    securitySchemes: {
+      ApiKeyAuthHeader: {
+        type: "apiKey",
+        in: "header",
+        name: "X-apiKey",
+        description: "Pass your API key via the X-apiKey request header."
+      },
+      ApiKeyAuthQuery: {
+        type: "apiKey",
+        in: "query",
+        name: "apiKey",
+        description: "Pass your API key via the apiKey query parameter."
+      }
+    },
+    schemas: {
+      DomainReputationResponse: {
+        type: "object",
+        required: [
+          "input",
+          "assessed_at",
+          "version",
+          "processing_time_ms",
+          "risk_category",
+          "dga_score",
+          "trust_signals",
+          "email_deliverability",
+          "intelligence",
+          "evidence_summary",
+          "errors"
+        ],
+        properties: {
+          input: {
+            type: "object",
+            required: ["domain"],
+            properties: {
+              domain: {
+                type: "string",
+                description: "Domain name being analyzed."
+              }
+            },
+            description: "Input object containing the analyzed domain."
+          },
+          assessed_at: {
+            type: "string",
+            description: "Timestamp when the assessment was performed (YYYY-MM-DDTHH:mm:ssZ)."
+          },
+          version: {
+            type: "string",
+            description: "API / response schema version."
+          },
+          processing_time_ms: {
+            type: "integer",
+            description: "Time taken to process the request, in milliseconds."
+          },
+          risk_category: {
+            $ref: "#/components/schemas/RiskCategory"
+          },
+          dga_score: {
+            $ref: "#/components/schemas/DgaScore"
+          },
+          trust_signals: {
+            $ref: "#/components/schemas/TrustSignals"
+          },
+          email_deliverability: {
+            $ref: "#/components/schemas/EmailDeliverability"
+          },
+          intelligence: {
+            $ref: "#/components/schemas/Intelligence"
+          },
+          evidence_summary: {
+            $ref: "#/components/schemas/EvidenceSummary"
+          },
+          errors: {
+            type: "array",
+            items: {
+              type: "string"
+            },
+            description: 'List of errors encountered during processing, if any (e.g. "WHOIS lookup failed"). An empty array means every signal resolved.'
+          }
+        },
+        description: "Full domain reputation assessment response."
+      },
+      RiskCategory: {
+        type: "object",
+        required: [
+          "verdict",
+          "confidence",
+          "primary_threat",
+          "severity",
+          "threat_types",
+          "sources",
+          "pivot_matches"
+        ],
+        properties: {
+          verdict: {
+            type: "string",
+            enum: ["safe", "suspicious"],
+            description: "Final verdict of the risk assessment."
+          },
+          confidence: {
+            type: "number",
+            format: "float",
+            description: "Confidence score for the verdict (0-1)."
+          },
+          primary_threat: {
+            type: ["string", "null"],
+            description: "Main threat type identified (e.g. phishing). null when no threat was identified."
+          },
+          severity: {
+            type: "string",
+            enum: ["none", "low", "medium", "high"],
+            description: "Severity level of the risk."
+          },
+          threat_types: {
+            type: "array",
+            items: {
+              type: "string"
+            },
+            description: "List of threat types associated with the domain."
+          },
+          sources: {
+            type: "array",
+            items: {
+              $ref: "#/components/schemas/ThreatSource"
+            },
+            description: "Threat intelligence sources that flagged the domain. Empty when nothing flagged it."
+          },
+          pivot_matches: {
+            type: "array",
+            items: {
+              $ref: "#/components/schemas/PivotMatch"
+            },
+            description: "Related pivots (nameserver, email, etc.) linked to known threats."
+          }
+        },
+        description: "Overall risk assessment for the domain."
+      },
+      ThreatSource: {
+        type: "object",
+        required: [
+          "source",
+          "indicator",
+          "threat_type",
+          "confidence",
+          "first_seen",
+          "last_seen"
+        ],
+        properties: {
+          source: {
+            type: "string",
+            description: "Name of the threat intelligence source (e.g. Spamhaus)."
+          },
+          indicator: {
+            type: "string",
+            description: "Indicator matched by this source."
+          },
+          threat_type: {
+            type: "string",
+            description: "Threat type reported by this source."
+          },
+          confidence: {
+            type: "number",
+            format: "float",
+            description: "Confidence score from this source (0-1)."
+          },
+          first_seen: {
+            type: "string",
+            description: "First time this indicator was seen by the source (YYYY-MM-DDTHH:mm:ssZ)."
+          },
+          last_seen: {
+            type: "string",
+            description: "Last time this indicator was seen by the source (YYYY-MM-DDTHH:mm:ssZ)."
+          }
+        },
+        description: "A threat intelligence source that flagged the domain."
+      },
+      PivotMatch: {
+        type: "object",
+        required: [
+          "pivot",
+          "pivot_type",
+          "total_related_threats",
+          "confidence"
+        ],
+        properties: {
+          pivot: {
+            type: "string",
+            description: "Pivot value (e.g. a nameserver or email address)."
+          },
+          pivot_type: {
+            type: "string",
+            description: "Type of pivot."
+          },
+          total_related_threats: {
+            type: "integer",
+            description: "Total number of threats related to this pivot."
+          },
+          confidence: {
+            type: "number",
+            format: "float",
+            description: "Confidence score for the pivot match (0-1)."
+          }
+        },
+        description: "A related pivot linked to known threats."
+      },
+      DgaScore: {
+        type: "object",
+        required: ["score", "is_dga", "model", "features", "interpretation"],
+        properties: {
+          score: {
+            type: "number",
+            format: "float",
+            description: "DGA likelihood score (0-1)."
+          },
+          is_dga: {
+            type: "boolean",
+            description: "Indicates whether the domain is likely DGA-generated."
+          },
+          model: {
+            type: "string",
+            description: "Model used to compute the DGA score."
+          },
+          features: {
+            $ref: "#/components/schemas/DgaFeatures"
+          },
+          interpretation: {
+            type: "string",
+            description: "Human-readable interpretation of the DGA score."
+          }
+        },
+        description: "Domain Generation Algorithm (DGA) detection results."
+      },
+      DgaFeatures: {
+        type: "object",
+        required: [
+          "domain_length",
+          "vowel_consonant_ratio",
+          "ngram_perplexity",
+          "shannon_entropy",
+          "digit_letter_ratio",
+          "consonant_streak_max",
+          "tld_in_known_dga_set"
+        ],
+        properties: {
+          domain_length: {
+            type: "integer",
+            description: "Length of the domain name."
+          },
+          vowel_consonant_ratio: {
+            type: "number",
+            format: "float",
+            description: "Ratio of vowels to consonants in the domain."
+          },
+          ngram_perplexity: {
+            type: "number",
+            format: "float",
+            description: "N-gram perplexity score of the domain string."
+          },
+          shannon_entropy: {
+            type: "number",
+            format: "float",
+            description: "Shannon entropy of the domain string."
+          },
+          digit_letter_ratio: {
+            type: "number",
+            format: "float",
+            description: "Ratio of digits to letters in the domain."
+          },
+          consonant_streak_max: {
+            type: "integer",
+            description: "Maximum consecutive consonant streak in the domain."
+          },
+          tld_in_known_dga_set: {
+            type: "boolean",
+            description: "Indicates if the TLD belongs to a known DGA set."
+          }
+        },
+        description: "Underlying lexical / statistical features used in DGA detection."
+      },
+      TrustSignals: {
+        type: "object",
+        required: ["trust_score", "trust_band", "signals", "indicators"],
+        properties: {
+          trust_score: {
+            type: "integer",
+            description: "Overall trust score (0-100)."
+          },
+          trust_band: {
+            type: "string",
+            description: "Trust score band / category (e.g. low, medium, high)."
+          },
+          signals: {
+            $ref: "#/components/schemas/TrustScoreSignals"
+          },
+          indicators: {
+            $ref: "#/components/schemas/TrustIndicators"
+          }
+        },
+        description: "Trust scoring and supporting signals for the domain."
+      },
+      TrustScoreSignals: {
+        type: "object",
+        required: ["positive", "negative", "neutral"],
+        properties: {
+          positive: {
+            type: "array",
+            items: {
+              $ref: "#/components/schemas/TrustSignalItem"
+            },
+            description: "Signals that positively affect the trust score."
+          },
+          negative: {
+            type: "array",
+            items: {
+              $ref: "#/components/schemas/TrustSignalItem"
+            },
+            description: "Signals that negatively affect the trust score."
+          },
+          neutral: {
+            type: "array",
+            items: {
+              $ref: "#/components/schemas/TrustSignalItem"
+            },
+            description: "Signals that are neutral to the trust score."
+          }
+        },
+        description: "Signals contributing to the trust score."
+      },
+      TrustSignalItem: {
+        type: "object",
+        required: [
+          "code",
+          "weight",
+          "polarity",
+          "category",
+          "evidence",
+          "confidence"
+        ],
+        properties: {
+          code: {
+            type: "string",
+            description: "Signal code identifier (e.g. valid_ssl, dmarc_missing)."
+          },
+          weight: {
+            type: "integer",
+            description: "Weight assigned to the signal."
+          },
+          polarity: {
+            type: "string",
+            enum: ["positive", "negative", "neutral"],
+            description: "Polarity of the signal."
+          },
+          category: {
+            type: "string",
+            description: "Category the signal belongs to (e.g. ssl_certificate)."
+          },
+          evidence: {
+            type: "string",
+            description: "Evidence supporting the signal."
+          },
+          confidence: {
+            type: "number",
+            format: "float",
+            description: "Confidence score for the signal (0-1)."
+          }
+        },
+        description: "A single trust signal contributing to the trust score."
+      },
+      TrustIndicators: {
+        type: "object",
+        properties: {
+          is_newly_registered: {
+            type: ["boolean", "null"],
+            description: "Indicates whether the domain was recently registered. null when WHOIS data is unavailable."
+          },
+          uses_free_extension: {
+            type: "boolean",
+            description: "Indicates whether the domain uses a free TLD extension."
+          },
+          uses_free_ssl: {
+            type: "boolean",
+            description: "Indicates whether the domain uses a free SSL certificate."
+          },
+          has_privacy_whois: {
+            type: ["boolean", "null"],
+            description: "Indicates whether WHOIS privacy protection is enabled. null when WHOIS data is unavailable."
+          },
+          ssl_age_days: {
+            type: ["integer", "null"],
+            description: "Age of the SSL certificate in days."
+          },
+          has_dmarc: {
+            type: "boolean",
+            description: "Indicates whether a DMARC record exists."
+          },
+          has_spf: {
+            type: "boolean",
+            description: "Indicates whether an SPF record exists."
+          },
+          redirects_externally: {
+            type: "boolean",
+            description: "Indicates whether the domain redirects to an external site."
+          },
+          javascript_obfuscated: {
+            type: "boolean",
+            description: "Indicates whether obfuscated JavaScript was detected."
+          },
+          domain_age_days: {
+            type: ["integer", "null"],
+            description: "Age of the domain in days. null when WHOIS data is unavailable."
+          },
+          registrar: {
+            type: ["string", "null"],
+            description: "Domain registrar name. null when WHOIS data is unavailable."
+          }
+        },
+        description: "Individual trust / risk indicators for the domain."
+      },
+      EmailDeliverability: {
+        type: "object",
+        required: [
+          "score",
+          "grade",
+          "can_receive_email",
+          "authentication",
+          "infrastructure",
+          "reputation",
+          "issues"
+        ],
+        properties: {
+          score: {
+            type: "integer",
+            description: "Overall email deliverability score out of 100."
+          },
+          grade: {
+            type: "string",
+            description: "Letter / word grade summarizing the deliverability score."
+          },
+          can_receive_email: {
+            type: "boolean",
+            description: "Indicates whether the domain is configured to receive email."
+          },
+          authentication: {
+            $ref: "#/components/schemas/EmailAuthentication"
+          },
+          infrastructure: {
+            $ref: "#/components/schemas/EmailInfrastructure"
+          },
+          reputation: {
+            $ref: "#/components/schemas/EmailReputation"
+          },
+          issues: {
+            type: "array",
+            items: {
+              $ref: "#/components/schemas/EmailIssue"
+            },
+            description: "List of detected email deliverability issues or misconfigurations."
+          }
+        },
+        description: "Assessment of the domain's ability to send and receive email reliably."
+      },
+      EmailAuthentication: {
+        type: "object",
+        required: ["spf", "dkim", "dmarc"],
+        properties: {
+          spf: {
+            $ref: "#/components/schemas/SpfRecord"
+          },
+          dkim: {
+            $ref: "#/components/schemas/DkimRecord"
+          },
+          dmarc: {
+            $ref: "#/components/schemas/DmarcRecord"
+          }
+        },
+        description: "Email authentication mechanisms configured for the domain."
+      },
+      SpfRecord: {
+        type: "object",
+        required: ["present", "policy", "record"],
+        properties: {
+          present: {
+            type: "boolean",
+            description: "Indicates whether an SPF record was found."
+          },
+          policy: {
+            type: "string",
+            description: "SPF enforcement policy qualifier found in the record (e.g. ~all, -all)."
+          },
+          record: {
+            type: "string",
+            description: "Raw SPF DNS TXT record string."
+          }
+        },
+        description: "Sender Policy Framework configuration."
+      },
+      DkimRecord: {
+        type: "object",
+        required: ["found", "selectors_found", "providers_detected", "note"],
+        properties: {
+          found: {
+            type: "boolean",
+            description: "Indicates whether a DKIM record was found for any probed selector."
+          },
+          selectors_found: {
+            type: "array",
+            items: {
+              type: "string"
+            },
+            description: "List of DKIM selectors for which a record was found."
+          },
+          providers_detected: {
+            type: "array",
+            items: {
+              type: "string"
+            },
+            description: "Email service providers inferred from the matched DKIM selectors."
+          },
+          note: {
+            type: "string",
+            description: "Clarifying note about the limitations of DKIM selector probing."
+          }
+        },
+        description: "DomainKeys Identified Mail configuration."
+      },
+      DmarcRecord: {
+        type: "object",
+        required: ["present", "policy", "reporting_configured"],
+        properties: {
+          present: {
+            type: "boolean",
+            description: "Indicates whether a DMARC record was found."
+          },
+          policy: {
+            type: "string",
+            description: "DMARC enforcement policy applied to failing messages (e.g. none, quarantine, reject)."
+          },
+          reporting_configured: {
+            type: "boolean",
+            description: "Indicates whether DMARC aggregate / forensic reporting addresses are configured."
+          }
+        },
+        description: "Domain-based Message Authentication, Reporting and Conformance configuration."
+      },
+      EmailInfrastructure: {
+        type: "object",
+        required: ["mx_count", "mx_records", "mx_provider", "null_mx"],
+        properties: {
+          mx_count: {
+            type: "integer",
+            description: "Number of MX records found for the domain."
+          },
+          mx_records: {
+            type: "array",
+            items: {
+              type: "string"
+            },
+            description: "List of mail exchange server hostnames for the domain."
+          },
+          mx_provider: {
+            type: "string",
+            description: "Email hosting provider inferred from the MX records."
+          },
+          null_mx: {
+            type: "boolean",
+            description: "Indicates whether the domain explicitly declines email via a null MX record."
+          }
+        },
+        description: "Mail server infrastructure backing the domain."
+      },
+      EmailReputation: {
+        type: "object",
+        required: ["spam_blacklisted", "newly_registered"],
+        properties: {
+          spam_blacklisted: {
+            type: "boolean",
+            description: "Indicates whether the domain appears on known spam blacklists."
+          },
+          newly_registered: {
+            type: "boolean",
+            description: "Indicates whether the domain was registered recently."
+          },
+          domain_age_days: {
+            type: ["integer", "null"],
+            description: "Age of the domain in days since registration."
+          }
+        },
+        description: "Reputation and trust signals related to the domain's email sending history."
+      },
+      EmailIssue: {
+        type: "object",
+        properties: {
+          code: {
+            type: "string",
+            description: "Machine-readable code identifying the specific deliverability issue."
+          },
+          severity: {
+            type: "string",
+            description: "Severity level assigned to the detected issue."
+          },
+          message: {
+            type: "string",
+            description: "Human-readable explanation of the issue."
+          },
+          recommendation: {
+            type: "string",
+            description: "Plain-language description of the exact fix to apply."
+          }
+        },
+        description: "A detected email deliverability issue or misconfiguration."
+      },
+      Intelligence: {
+        type: "object",
+        required: [
+          "ioc_type",
+          "ioc_value",
+          "related_iocs",
+          "feed_tags",
+          "stix_pattern",
+          "recommended_action",
+          "first_seen",
+          "last_seen"
+        ],
+        properties: {
+          ioc_type: {
+            type: "string",
+            description: "Type of the indicator of compromise (e.g. domain)."
+          },
+          ioc_value: {
+            type: "string",
+            description: "Value of the indicator of compromise."
+          },
+          related_iocs: {
+            type: "array",
+            items: {
+              $ref: "#/components/schemas/RelatedIoc"
+            },
+            description: "Other IOCs related to this domain."
+          },
+          feed_tags: {
+            type: "array",
+            items: {
+              type: "string"
+            },
+            description: "Tags associated with this IOC from threat feeds."
+          },
+          stix_pattern: {
+            type: "string",
+            description: "STIX 2.1 pattern representation of the IOC, ready to wrap into an Indicator object."
+          },
+          recommended_action: {
+            type: "string",
+            enum: ["allow", "monitor", "block"],
+            description: "Recommended action based on the assessment."
+          },
+          first_seen: {
+            type: ["string", "null"],
+            description: "First time this IOC was observed (YYYY-MM-DDTHH:mm:ssZ). null when never observed on a feed."
+          },
+          last_seen: {
+            type: ["string", "null"],
+            description: "Last time this IOC was observed (YYYY-MM-DDTHH:mm:ssZ). null when never observed on a feed."
+          }
+        },
+        description: "Threat intelligence details for the indicator of compromise (IOC)."
+      },
+      RelatedIoc: {
+        type: "object",
+        required: ["type", "value", "confidence"],
+        properties: {
+          type: {
+            type: "string",
+            description: "Type of the related IOC (e.g. ipv4, ipv6)."
+          },
+          value: {
+            type: "string",
+            description: "Value of the related IOC."
+          },
+          confidence: {
+            type: "number",
+            format: "float",
+            description: "Confidence score for the related IOC (0-1)."
+          }
+        },
+        description: "A related indicator of compromise."
+      },
+      EvidenceSummary: {
+        type: "object",
+        required: ["why_flagged"],
+        properties: {
+          why_flagged: {
+            type: "array",
+            items: {
+              type: "string"
+            },
+            description: "List of reasons why the domain was flagged. Empty for a clean domain."
+          }
+        },
+        description: "Summary of reasons behind the risk assessment."
+      },
+      ErrorResponse: {
+        type: "object",
+        description: "Standard error envelope returned by the API on failed requests.",
+        required: ["message"],
+        properties: {
+          error: {
+            type: "string",
+            description: "Short error category or exception type."
+          },
+          message: {
+            type: "string",
+            description: "Human-readable error message describing the failure."
+          },
+          path: {
+            type: "string",
+            description: "API endpoint path that produced the error."
+          },
+          status: {
+            type: "integer",
+            description: "HTTP status code returned with the error."
+          },
+          timestamp: {
+            type: "string",
+            format: "date-time",
+            description: "Timestamp when the error occurred (ISO 8601)."
+          }
+        }
+      }
+    },
+    headers: {
+      "X-AF-Credits-Cost": {
+        description: "Specifies the number of credits consumed by the current request.",
+        schema: {
+          type: "integer"
+        }
+      }
+    }
+  },
+  security: [
+    {
+      ApiKeyAuthHeader: []
+    },
+    {
+      ApiKeyAuthQuery: []
+    }
+  ]
+};
+
 // specs/domain/domain-search-with-suggestions.json
 var domain_search_with_suggestions_default = {
   openapi: "3.1.1",
@@ -7244,47 +8360,278 @@ var domain_search_with_suggestions_default = {
     schemas: {
       DomainAvailabilityResponse: {
         type: "object",
-        description: "Domain availability check response containing the domain name and availability status. Returned when sug=false.",
+        description: "Domain availability check response containing the domain name and availability status. Returned when sug=false.",
+        required: ["domain", "domainAvailability"],
+        properties: {
+          domain: {
+            type: "string",
+            description: "Name of the queried domain."
+          },
+          domainAvailability: {
+            type: "boolean",
+            description: "True if available, false if not available."
+          }
+        }
+      },
+      DomainSuggestionResponse: {
+        type: "object",
+        required: ["domain_available_response"],
+        properties: {
+          domain_available_response: {
+            type: "array",
+            description: "List of domain availability objects.",
+            items: {
+              $ref: "#/components/schemas/DomainSuggestionItem"
+            }
+          }
+        },
+        description: "Domain suggestion response containing a list of availability-suggestions."
+      },
+      DomainSuggestionItem: {
+        type: "object",
+        description: "A single domain suggestion with availability status.",
+        required: ["domain", "domainAvailability"],
+        properties: {
+          domain: {
+            type: "string",
+            description: "Name of the suggested domain."
+          },
+          domainAvailability: {
+            type: "boolean",
+            description: "True if available, false if not available."
+          }
+        }
+      },
+      ErrorResponse: {
+        type: "object",
+        description: "Standard error envelope returned by the API on failed requests.",
+        required: ["message"],
+        properties: {
+          error: {
+            type: "string",
+            description: "Short error category or exception type."
+          },
+          message: {
+            type: "string",
+            description: "Human-readable error message describing the failure."
+          },
+          path: {
+            type: "string",
+            description: "API endpoint path that produced the error."
+          },
+          status: {
+            type: "integer",
+            description: "HTTP status code returned with the error."
+          },
+          timestamp: {
+            type: "string",
+            format: "date-time",
+            description: "Timestamp when the error occurred (ISO 8601)."
+          }
+        }
+      }
+    },
+    headers: {
+      "X-AF-Credits-Cost": {
+        description: "Specifies the number of credits consumed by the current request.",
+        schema: {
+          type: "integer"
+        }
+      }
+    }
+  },
+  security: [
+    {
+      ApiKeyAuthHeader: []
+    },
+    {
+      ApiKeyAuthQuery: []
+    }
+  ]
+};
+
+// specs/domain/domain-search.json
+var domain_search_default = {
+  openapi: "3.1.1",
+  info: {
+    title: "Domain Availability API - Check Domain Names in Real Time and Get Suggestions",
+    version: "1.0.0",
+    description: "Check whether a domain is available for registration across all top-level domains (TLDs) and second-level domains (SLDs). Uses DNS-based or WHOIS-based lookups to determine domain availability. Returns a simple response with the domain name and a boolean availability indicator.",
+    contact: {
+      name: "APIFreaks Support",
+      url: "https://apifreaks.com/contact",
+      email: "support@apifreaks.com"
+    }
+  },
+  servers: [
+    {
+      url: "https://api.apifreaks.com/v1.0",
+      description: "Domain Search API Server"
+    }
+  ],
+  paths: {
+    "/domain/availability": {
+      get: {
+        tags: ["Domain APIs"],
+        summary: "Check whether a domain is available for registration or not.",
+        description: "The Domain Search API is designed to simplify the process of finding available domain names across all top-level domains (TLDs) and second-level domains (SLDs).",
+        parameters: [
+          {
+            name: "format",
+            in: "query",
+            required: false,
+            schema: {
+              type: "string",
+              enum: ["json", "xml"],
+              default: "json"
+            },
+            description: "Format of the response."
+          },
+          {
+            name: "domain",
+            in: "query",
+            required: true,
+            schema: {
+              type: "string"
+            },
+            description: "Domain name whose availability is to be checked."
+          },
+          {
+            name: "source",
+            in: "query",
+            required: false,
+            schema: {
+              type: "string",
+              enum: ["dns", "whois"],
+              default: "dns"
+            },
+            description: 'Specify the data source for domain availability checks. Use "dns" for DNS-based lookups or "whois" for WHOIS-based lookups. By default, "dns" is used.'
+          }
+        ],
+        responses: {
+          "200": {
+            description: "Success",
+            content: {
+              "application/json": {
+                schema: {
+                  $ref: "#/components/schemas/DomainAvailabilityResponse"
+                },
+                examples: {
+                  success: {
+                    summary: "Domain available",
+                    value: {
+                      domain: "google.com",
+                      domainAvailability: false
+                    }
+                  }
+                }
+              }
+            },
+            headers: {
+              "X-AF-Credits-Cost": {
+                $ref: "#/components/headers/X-AF-Credits-Cost"
+              }
+            }
+          },
+          "400": {
+            description: "Bad Request \u2013 Missing domain, or domain has an unrecognized/unsupported TLD",
+            content: {
+              "application/json": {
+                schema: {
+                  $ref: "#/components/schemas/ErrorResponse"
+                },
+                examples: {
+                  missingDomain: {
+                    summary: "Missing required domain parameter",
+                    value: {
+                      error: "Invalid Param Exception",
+                      message: "please pass correct parameters",
+                      path: "/v1.0/domain/availability",
+                      status: 400,
+                      timestamp: "2026-07-27T12:18:21.115Z"
+                    }
+                  },
+                  unsupportedTld: {
+                    summary: "Domain has an unrecognized or unsupported TLD",
+                    value: {
+                      timestamp: "2026-07-27T12:18:47.346748812Z",
+                      status: 400,
+                      error: "Invalid Param Exception",
+                      message: "Please pass domain param correct value [For Technical Support: support@whoisfreaks.com]",
+                      path: "/v1.0/domain/availability"
+                    }
+                  }
+                }
+              }
+            },
+            headers: {
+              "X-AF-Credits-Cost": {
+                $ref: "#/components/headers/X-AF-Credits-Cost"
+              }
+            }
+          },
+          "408": {
+            description: "Request Timeout \u2013 Unable to fetch WHOIS data",
+            content: {
+              "application/json": {
+                schema: {
+                  $ref: "#/components/schemas/ErrorResponse"
+                },
+                examples: {
+                  error: {
+                    summary: "Error response",
+                    value: {
+                      timestamp: "2025-08-14T10:37:21.871Z",
+                      status: 408,
+                      error: "Request Timeout",
+                      message: "Unable to fetch whois data. Please try again. [For Technical Support email at: support@apifreaks.com]",
+                      path: "/v1.0/domain/availability"
+                    }
+                  }
+                }
+              }
+            },
+            headers: {
+              "X-AF-Credits-Cost": {
+                $ref: "#/components/headers/X-AF-Credits-Cost"
+              }
+            }
+          }
+        },
+        operationId: "checkDomainAvailability"
+      }
+    }
+  },
+  components: {
+    securitySchemes: {
+      ApiKeyAuthHeader: {
+        type: "apiKey",
+        in: "header",
+        name: "X-apiKey",
+        description: "Pass your API key via the X-apiKey request header."
+      },
+      ApiKeyAuthQuery: {
+        type: "apiKey",
+        in: "query",
+        name: "apiKey",
+        description: "Pass your API key via the apiKey query parameter."
+      }
+    },
+    schemas: {
+      DomainAvailabilityResponse: {
+        type: "object",
         required: ["domain", "domainAvailability"],
         properties: {
           domain: {
             type: "string",
-            description: "Name of the queried domain."
+            description: "Name of the queried domain"
           },
           domainAvailability: {
             type: "boolean",
-            description: "True if available, false if not available."
-          }
-        }
-      },
-      DomainSuggestionResponse: {
-        type: "object",
-        required: ["domain_available_response"],
-        properties: {
-          domain_available_response: {
-            type: "array",
-            description: "List of domain availability objects.",
-            items: {
-              $ref: "#/components/schemas/DomainSuggestionItem"
-            }
+            description: "True if available, false if not available"
           }
         },
-        description: "Domain suggestion response containing a list of availability-suggestions."
-      },
-      DomainSuggestionItem: {
-        type: "object",
-        description: "A single domain suggestion with availability status.",
-        required: ["domain", "domainAvailability"],
-        properties: {
-          domain: {
-            type: "string",
-            description: "Name of the suggested domain."
-          },
-          domainAvailability: {
-            type: "boolean",
-            description: "True if available, false if not available."
-          }
-        }
+        description: "Domain availability check response containing the domain name and availability status."
       },
       ErrorResponse: {
         type: "object",
@@ -7334,13 +8681,13 @@ var domain_search_with_suggestions_default = {
   ]
 };
 
-// specs/domain/domain-search.json
-var domain_search_default = {
+// specs/domain/domain-typosquatting.json
+var domain_typosquatting_default = {
   openapi: "3.1.1",
   info: {
-    title: "Domain Availability API - Check Domain Names in Real Time and Get Suggestions",
+    title: "Domain Typosquatting API - Find Typo and Look-Alike Domains for Brand Protection and Phishing Discovery",
     version: "1.0.0",
-    description: "Check whether a domain is available for registration across all top-level domains (TLDs) and second-level domains (SLDs). Uses DNS-based or WHOIS-based lookups to determine domain availability. Returns a simple response with the domain name and a boolean availability indicator.",
+    description: "Search for registered domains that read like typo variants of a brand keyword, or that match a wildcard pattern, across the full TLD set. Each match returns what is available of its registration date, expiry date, last-seen date, and drop status, paginated at 100 domains per page. Built for brand and trademark protection, phishing discovery, scheduled monitoring, and domain reclaim.",
     contact: {
       name: "APIFreaks Support",
       url: "https://apifreaks.com/contact",
@@ -7350,15 +8697,15 @@ var domain_search_default = {
   servers: [
     {
       url: "https://api.apifreaks.com/v1.0",
-      description: "Domain Search API Server"
+      description: "Domain Typosquatting API Server"
     }
   ],
   paths: {
-    "/domain/availability": {
+    "/domain/typosquatting": {
       get: {
         tags: ["Domain APIs"],
-        summary: "Check whether a domain is available for registration or not.",
-        description: "The Domain Search API is designed to simplify the process of finding available domain names across all top-level domains (TLDs) and second-level domains (SLDs).",
+        summary: "Find registered typo-variant or wildcard-pattern domains for a brand keyword.",
+        description: "The Domain Typosquatting API searches for registered domains that are typo or look-alike variants of a brand keyword, or that match a wildcard pattern. Results include registration lifecycle data and drop status across 1529+ TLDs, paginated at 100 domains per page.",
         parameters: [
           {
             name: "format",
@@ -7372,24 +8719,35 @@ var domain_search_default = {
             description: "Format of the response."
           },
           {
-            name: "domain",
+            name: "keyword",
             in: "query",
-            required: true,
+            required: false,
             schema: {
-              type: "string"
+              type: "string",
+              minLength: 3,
+              maxLength: 63
             },
-            description: "Domain name whose availability is to be checked."
+            description: "Brand or label to find typo variants for. 3-63 characters, letters, digits, or hyphens, a single label with no dots. Case-insensitive. Use either keyword or pattern, never both."
           },
           {
-            name: "source",
+            name: "pattern",
             in: "query",
             required: false,
             schema: {
               type: "string",
-              enum: ["dns", "whois"],
-              default: "dns"
+              minLength: 3,
+              maxLength: 63
             },
-            description: 'Specify the data source for domain availability checks. Use "dns" for DNS-based lookups or "whois" for WHOIS-based lookups. By default, "dns" is used.'
+            description: "Wildcard search string that combines fuzzy matching with * wildcards. 3-63 characters total, * is the only supported wildcard and each one matches zero or more characters, maximum 3 asterisks per request. Use either keyword or pattern, never both."
+          },
+          {
+            name: "pageToken",
+            in: "query",
+            required: false,
+            schema: {
+              type: "string"
+            },
+            description: "Token from nextPageToken in the previous response. Required to retrieve page 2 and onward. The original keyword or pattern must be passed alongside the token on every page request. Results page at 100 domains per page."
           }
         ],
         responses: {
@@ -7398,14 +8756,85 @@ var domain_search_default = {
             content: {
               "application/json": {
                 schema: {
-                  $ref: "#/components/schemas/DomainAvailabilityResponse"
+                  $ref: "#/components/schemas/DomainTyposquattingResponse"
                 },
                 examples: {
-                  success: {
-                    summary: "Domain available",
+                  keywordSuccess: {
+                    summary: "Keyword search (paypal)",
                     value: {
-                      domain: "google.com",
-                      domainAvailability: false
+                      status: true,
+                      totalRecords: 1284,
+                      currentPage: 1,
+                      hasNextPage: true,
+                      totalPages: 13,
+                      nextPageToken: "<opaque_token>",
+                      domains: [
+                        {
+                          domainName: "p-aypal.com",
+                          createDate: "2025-04-17",
+                          expiryDate: "2026-04-17",
+                          lastSeen: "2026-05-29",
+                          isDropped: true
+                        },
+                        {
+                          domainName: "p-aypal.de",
+                          lastSeen: "2024-07-11",
+                          isDropped: true
+                        },
+                        {
+                          domainName: "p0aypal.com",
+                          createDate: "2017-12-29",
+                          expiryDate: "2026-12-29",
+                          lastSeen: "2026-08-18",
+                          isDropped: false
+                        },
+                        {
+                          domainName: "p7ypal.com",
+                          isDropped: true
+                        },
+                        {
+                          domainName: "pa-pal.club",
+                          createDate: "2019-10-25",
+                          expiryDate: "2020-10-25",
+                          isDropped: false
+                        }
+                      ]
+                    }
+                  },
+                  patternSuccess: {
+                    summary: "Wildcard pattern search (*paypal*)",
+                    value: {
+                      status: true,
+                      totalRecords: 5471,
+                      currentPage: 1,
+                      hasNextPage: true,
+                      totalPages: 55,
+                      nextPageToken: "<opaque_token>",
+                      domains: [
+                        {
+                          domainName: "paypal-support.com",
+                          createDate: "2024-11-02",
+                          expiryDate: "2026-11-02",
+                          lastSeen: "2026-08-30",
+                          isDropped: false
+                        },
+                        {
+                          domainName: "login-paypal.net",
+                          lastSeen: "2025-12-14",
+                          isDropped: true
+                        }
+                      ]
+                    }
+                  },
+                  emptyResult: {
+                    summary: "No matches found",
+                    value: {
+                      status: true,
+                      totalRecords: 0,
+                      currentPage: 1,
+                      hasNextPage: false,
+                      totalPages: 0,
+                      domains: []
                     }
                   }
                 }
@@ -7418,58 +8847,41 @@ var domain_search_default = {
             }
           },
           "400": {
-            description: "Bad Request \u2013 Missing domain, or domain has an unrecognized/unsupported TLD",
+            description: "Bad Request \u2013 Invalid parameters",
             content: {
               "application/json": {
                 schema: {
                   $ref: "#/components/schemas/ErrorResponse"
                 },
                 examples: {
-                  missingDomain: {
-                    summary: "Missing required domain parameter",
+                  shortPattern: {
+                    summary: "Pattern has too few non-wildcard characters",
                     value: {
-                      error: "Invalid Param Exception",
-                      message: "please pass correct parameters",
-                      path: "/v1.0/domain/availability",
+                      error: "Invalid Pattern Exception",
+                      message: "The pattern must contain at least 5 non-wildcard characters and no more than 3 wildcards.",
+                      path: "/v1.0/domain/typosquatting",
                       status: 400,
-                      timestamp: "2026-07-27T12:18:21.115Z"
+                      timestamp: "2026-09-08T12:00:00.000Z"
                     }
                   },
-                  unsupportedTld: {
-                    summary: "Domain has an unrecognized or unsupported TLD",
+                  bothParams: {
+                    summary: "Both keyword and pattern supplied",
                     value: {
-                      timestamp: "2026-07-27T12:18:47.346748812Z",
-                      status: 400,
                       error: "Invalid Param Exception",
-                      message: "Please pass domain param correct value [For Technical Support: support@whoisfreaks.com]",
-                      path: "/v1.0/domain/availability"
+                      message: 'Use either the "keyword" or the "pattern" parameter, never both.',
+                      path: "/v1.0/domain/typosquatting",
+                      status: 400,
+                      timestamp: "2026-09-08T12:00:00.000Z"
                     }
-                  }
-                }
-              }
-            },
-            headers: {
-              "X-AF-Credits-Cost": {
-                $ref: "#/components/headers/X-AF-Credits-Cost"
-              }
-            }
-          },
-          "408": {
-            description: "Request Timeout \u2013 Unable to fetch WHOIS data",
-            content: {
-              "application/json": {
-                schema: {
-                  $ref: "#/components/schemas/ErrorResponse"
-                },
-                examples: {
-                  error: {
-                    summary: "Error response",
+                  },
+                  missingParam: {
+                    summary: "Neither keyword nor pattern supplied",
                     value: {
-                      timestamp: "2025-08-14T10:37:21.871Z",
-                      status: 408,
-                      error: "Request Timeout",
-                      message: "Unable to fetch whois data. Please try again. [For Technical Support email at: support@apifreaks.com]",
-                      path: "/v1.0/domain/availability"
+                      error: "Invalid Param Exception",
+                      message: 'Please provide either a "keyword" or a "pattern" parameter.',
+                      path: "/v1.0/domain/typosquatting",
+                      status: 400,
+                      timestamp: "2026-09-08T12:00:00.000Z"
                     }
                   }
                 }
@@ -7482,7 +8894,7 @@ var domain_search_default = {
             }
           }
         },
-        operationId: "checkDomainAvailability"
+        operationId: "getDomainTyposquatting"
       }
     }
   },
@@ -7502,20 +8914,70 @@ var domain_search_default = {
       }
     },
     schemas: {
-      DomainAvailabilityResponse: {
+      DomainTyposquattingResponse: {
         type: "object",
-        required: ["domain", "domainAvailability"],
+        required: ["status", "totalRecords", "currentPage", "hasNextPage", "totalPages", "domains"],
         properties: {
-          domain: {
+          status: {
+            type: "boolean",
+            description: "Indicates if the request was successful."
+          },
+          totalRecords: {
+            type: "integer",
+            description: "Total number of domains found."
+          },
+          currentPage: {
+            type: "integer",
+            description: "Page number of the current response. Starts at 1."
+          },
+          hasNextPage: {
+            type: "boolean",
+            description: "true if at least one additional page is available."
+          },
+          totalPages: {
+            type: "integer",
+            description: "Total number of pages available."
+          },
+          nextPageToken: {
             type: "string",
-            description: "Name of the queried domain"
+            description: "Opaque token to pass as pageToken on the next request. Present only when hasNextPage is true."
           },
-          domainAvailability: {
+          domains: {
+            type: "array",
+            items: {
+              $ref: "#/components/schemas/DomainItem"
+            },
+            description: "List of typo-variant or pattern-matched domains on the current page."
+          }
+        },
+        description: "Paginated response containing typo-variant or pattern-matched domains."
+      },
+      DomainItem: {
+        type: "object",
+        required: ["domainName", "isDropped"],
+        properties: {
+          domainName: {
+            type: "string",
+            description: "Domain name."
+          },
+          createDate: {
+            type: "string",
+            description: "Domain creation date (YYYY-MM-DD). May be absent for older or less-actively-tracked entries."
+          },
+          expiryDate: {
+            type: "string",
+            description: "Domain expiration date (YYYY-MM-DD). May be absent for older or less-actively-tracked entries."
+          },
+          lastSeen: {
+            type: "string",
+            description: "Last time the domain was observed (YYYY-MM-DD). One of the two fields reliably meaningful across a full result set."
+          },
+          isDropped: {
             type: "boolean",
-            description: "True if available, false if not available"
+            description: "Indicates whether the domain has dropped out of the registry and become available to register again."
           }
         },
-        description: "Domain availability check response containing the domain name and availability status."
+        description: "A single typo-variant or pattern-matched domain with registration lifecycle data."
       },
       ErrorResponse: {
         type: "object",
@@ -7939,7 +9401,7 @@ var bulk_email_validation_default = {
   info: {
     title: "Bulk Email Validation API - Validate and Verify Emails in Bulk",
     version: "1.0.0",
-    description: "Validate up to 10 email addresses in a single POST request. Each email is processed independently. Returns an array of validation results with deliverability assessment per email, plus per-item error objects for failed validations. Maximum 10 email addresses per request.",
+    description: "Validate up to 10 email addresses in a single POST request. Each email is processed independently. Returns an array of validation results with deliverability assessment per email (valid/accept_all/invalid/unknown/risky/app_server_blocked), plus per-item error objects for failed validations. Maximum 10 email addresses per request.",
     contact: {
       name: "APIFreaks Support",
       url: "https://apifreaks.com/contact",
@@ -7991,7 +9453,7 @@ var bulk_email_validation_default = {
                 },
                 examples: {
                   bulkEmailsValidated: {
-                    summary: "Mix of a valid and a syntactically invalid email",
+                    summary: "Mix of valid, syntactically invalid, accept_all, null-MX invalid, and unknown (no-MX probe) results",
                     value: {
                       emailResponse: [
                         {
@@ -8030,6 +9492,74 @@ var bulk_email_validation_default = {
                             name: "not-an-email",
                             validDomain: false
                           }
+                        },
+                        {
+                          success: true,
+                          email: "random12345@yahoo.com",
+                          validEmail: "accept_all",
+                          validSyntax: true,
+                          reason: "domain accepts all addresses.",
+                          domain: {
+                            name: "yahoo.com",
+                            disposable: false,
+                            spam: false,
+                            free: true,
+                            validDomain: true,
+                            catchAll: true
+                          },
+                          account: {
+                            role: false,
+                            fullMailBox: false
+                          },
+                          dns: {
+                            mxRecord: [
+                              "mta5.am0.yahoodns.net.",
+                              "mta6.am0.yahoodns.net.",
+                              "mta7.am0.yahoodns.net."
+                            ]
+                          }
+                        },
+                        {
+                          success: true,
+                          email: "test@example.com",
+                          validEmail: "invalid",
+                          validSyntax: true,
+                          reason: "domain does not accept mail.",
+                          domain: {
+                            name: "example.com",
+                            disposable: true,
+                            spam: false,
+                            free: false,
+                            validDomain: true,
+                            catchAll: false
+                          },
+                          account: {
+                            role: false
+                          },
+                          dns: {
+                            mxRecord: ["."]
+                          }
+                        },
+                        {
+                          success: true,
+                          email: "test@neverssl.com",
+                          validEmail: "unknown",
+                          validSyntax: true,
+                          reason: "We are unable to determine if email is valid or invalid.",
+                          domain: {
+                            name: "neverssl.com",
+                            disposable: false,
+                            spam: false,
+                            free: false,
+                            validDomain: true,
+                            catchAll: false
+                          },
+                          account: {
+                            role: false
+                          },
+                          dns: {
+                            aRecord: ["34.223.124.45"]
+                          }
                         }
                       ]
                     }
@@ -8234,19 +9764,20 @@ var bulk_email_validation_default = {
           },
           reason: {
             type: "string",
-            description: "Detailed explanation returned when validEmail is not valid."
+            description: "Detailed explanation returned when validEmail is not valid. Omitted entirely when validEmail is valid."
           },
           validEmail: {
             type: "string",
             enum: [
               "valid",
+              "accept_all",
               "invalid",
               "INVALID_EMAIL",
               "unknown",
               "risky",
               "app_server_blocked"
             ],
-            description: "Comprehensive deliverability assessment. Casing is inconsistent in the live API: syntactically invalid addresses return INVALID_EMAIL, while semantically invalid (undeliverable) addresses return lowercase invalid. risky is a documented possibility not observed during testing. app_server_blocked is returned when the recipient mail server blocked the live verification attempt (reason explains that retrying later may succeed)."
+            description: "Comprehensive deliverability assessment. valid: recipient confirmed deliverable, reason omitted. accept_all: the domain is catch-all and accepted the recipient, so this specific mailbox is unconfirmed \u2014 see domain.catchAll, reason 'domain accepts all addresses.'. invalid: rejected mailbox, syntax failure, or the domain accepts no mail at all (a null MX). unknown: no conclusive answer, most common for domains with no MX record that only get a probe against their address record. risky: mailbox exists but over quota, or the server deferred with a greylist response. app_server_blocked: our verifier IP was blocked by the receiving server. Casing is inconsistent in the live API: syntactically invalid addresses can return the raw enum name INVALID_EMAIL instead of lowercase invalid \u2014 this is a known API bug, handle it defensively as equivalent to invalid."
           },
           validSyntax: {
             type: "boolean",
@@ -8298,7 +9829,7 @@ var bulk_email_validation_default = {
           },
           catchAll: {
             type: "boolean",
-            description: "Detection flag for domains configured to accept mail for any recipient address."
+            description: "Detection flag for domains configured to accept mail for any recipient address. true always corresponds to a top-level validEmail of accept_all."
           }
         },
         description: "Domain validation details for the email address."
@@ -8320,24 +9851,24 @@ var bulk_email_validation_default = {
       },
       DnsObject: {
         type: "object",
-        required: ["mxRecord"],
+        required: [],
         properties: {
           mxRecord: {
             type: "array",
             items: {
               type: "string"
             },
-            description: "Collection of MX (Mail Exchange) hostname records from DNS queries."
+            description: `Every MX hostname at the domain's lowest preference (not just one). ["."]  means the domain publishes a null MX and accepts no mail at all. Absent entirely when the domain has no MX record of any kind \u2014 check aRecord in that case.`
           },
           aRecord: {
             type: "array",
             items: {
               type: "string"
             },
-            description: "Collection of A (Address) records for the domain. Not observed in testing \u2014 may be rarely or never populated."
+            description: "Collection of A (Address) records for the domain. Present when the domain has no MX record but does resolve to a web server or other host."
           }
         },
-        description: "DNS records for the email domain."
+        description: "DNS records for the email domain. Absent entirely when the domain publishes neither an MX nor an A record."
       },
       AddressObject: {
         type: "object",
@@ -8580,7 +10111,7 @@ var email_checker_default = {
   info: {
     title: "Email Checker API - Real-Time Validation, Deliverability & Risk Signals",
     version: "1.0.0",
-    description: "Validate a single email address and receive comprehensive results including syntax validation, domain verification, account detection, DNS records (MX and A records), and optional IP-based geolocation and security enrichment. Returns deliverability assessment with valid/invalid/unknown/risky/app_server_blocked status.",
+    description: "Validate a single email address and receive comprehensive results including syntax validation, domain verification, account detection, DNS records (MX and A records), and optional IP-based geolocation and security enrichment. Returns deliverability assessment with valid/accept_all/invalid/unknown/risky/app_server_blocked status.",
     contact: {
       name: "APIFreaks Support",
       url: "https://apifreaks.com/contact",
@@ -8673,8 +10204,8 @@ var email_checker_default = {
                       }
                     }
                   },
-                  noMxRecord: {
-                    summary: "Valid syntax, domain has no MX record",
+                  nonexistentDomain: {
+                    summary: "Valid syntax, domain does not exist (NXDOMAIN)",
                     value: {
                       success: true,
                       email: "test@nonexistentdomainxyz123abc.com",
@@ -8694,6 +10225,83 @@ var email_checker_default = {
                       }
                     }
                   },
+                  acceptAll: {
+                    summary: "Catch-all domain accepted the recipient \u2014 mailbox unconfirmed",
+                    value: {
+                      success: true,
+                      email: "random12345@yahoo.com",
+                      validEmail: "accept_all",
+                      validSyntax: true,
+                      reason: "domain accepts all addresses.",
+                      domain: {
+                        name: "yahoo.com",
+                        disposable: false,
+                        spam: false,
+                        free: true,
+                        validDomain: true,
+                        catchAll: true
+                      },
+                      account: {
+                        role: false,
+                        fullMailBox: false
+                      },
+                      dns: {
+                        mxRecord: [
+                          "mta5.am0.yahoodns.net.",
+                          "mta6.am0.yahoodns.net.",
+                          "mta7.am0.yahoodns.net."
+                        ]
+                      }
+                    }
+                  },
+                  nullMxDomain: {
+                    summary: 'Domain publishes a null MX (single ".") \u2014 accepts no mail at all',
+                    value: {
+                      success: true,
+                      email: "test@example.com",
+                      validEmail: "invalid",
+                      validSyntax: true,
+                      reason: "domain does not accept mail.",
+                      domain: {
+                        name: "example.com",
+                        disposable: true,
+                        spam: false,
+                        free: false,
+                        validDomain: true,
+                        catchAll: false
+                      },
+                      account: {
+                        role: false
+                      },
+                      dns: {
+                        mxRecord: ["."]
+                      }
+                    }
+                  },
+                  noMxAddressOnly: {
+                    summary: "Domain has no MX record but a working A record \u2014 gets a real SMTP probe",
+                    value: {
+                      success: true,
+                      email: "test@neverssl.com",
+                      validEmail: "unknown",
+                      validSyntax: true,
+                      reason: "We are unable to determine if email is valid or invalid.",
+                      domain: {
+                        name: "neverssl.com",
+                        disposable: false,
+                        spam: false,
+                        free: false,
+                        validDomain: true,
+                        catchAll: false
+                      },
+                      account: {
+                        role: false
+                      },
+                      dns: {
+                        aRecord: ["34.223.124.45"]
+                      }
+                    }
+                  },
                   withIp: {
                     summary: "With ip \u2014 adds geolocation/security enrichment under address",
                     value: {
@@ -8964,12 +10572,12 @@ var email_checker_default = {
           },
           reason: {
             type: "string",
-            description: "Detailed explanation returned when validEmail is not valid."
+            description: "Detailed explanation returned when validEmail is not valid. Omitted entirely when validEmail is valid."
           },
           validEmail: {
             type: "string",
-            enum: ["valid", "invalid", "INVALID_EMAIL", "unknown", "risky", "app_server_blocked"],
-            description: "Comprehensive deliverability assessment. Casing is inconsistent in the live API: syntactically invalid addresses return INVALID_EMAIL, while semantically invalid (undeliverable) addresses return lowercase invalid. risky is a documented possibility not observed during testing. app_server_blocked is returned when the recipient mail server blocked the live verification attempt (reason explains that retrying later may succeed)."
+            enum: ["valid", "accept_all", "invalid", "INVALID_EMAIL", "unknown", "risky", "app_server_blocked"],
+            description: "Comprehensive deliverability assessment. valid: recipient confirmed deliverable, reason omitted. accept_all: the domain is catch-all and accepted the recipient, so this specific mailbox is unconfirmed \u2014 see domain.catchAll, reason 'domain accepts all addresses.'. invalid: rejected mailbox, syntax failure, or the domain accepts no mail at all (a null MX). unknown: no conclusive answer, most common for domains with no MX record that only get a probe against their address record. risky: mailbox exists but over quota, or the server deferred with a greylist response. app_server_blocked: our verifier IP was blocked by the receiving server. Casing is inconsistent in the live API: syntactically invalid addresses can return the raw enum name INVALID_EMAIL instead of lowercase invalid \u2014 this is a known API bug, handle it defensively as equivalent to invalid."
           },
           validSyntax: {
             type: "boolean",
@@ -9021,7 +10629,7 @@ var email_checker_default = {
           },
           catchAll: {
             type: "boolean",
-            description: "Detection flag for domains configured to accept mail for any recipient address."
+            description: "Detection flag for domains configured to accept mail for any recipient address. true always corresponds to a top-level validEmail of accept_all."
           }
         },
         description: "Domain validation details for the email address."
@@ -9043,24 +10651,24 @@ var email_checker_default = {
       },
       DnsObject: {
         type: "object",
-        required: ["mxRecord"],
+        required: [],
         properties: {
           mxRecord: {
             type: "array",
             items: {
               type: "string"
             },
-            description: "Collection of MX (Mail Exchange) hostname records from DNS queries."
+            description: `Every MX hostname at the domain's lowest preference (not just one). ["."]  means the domain publishes a null MX and accepts no mail at all. Absent entirely when the domain has no MX record of any kind \u2014 check aRecord in that case.`
           },
           aRecord: {
             type: "array",
             items: {
               type: "string"
             },
-            description: "Collection of A (Address) records for the domain. Not observed in testing \u2014 may be rarely or never populated."
+            description: "Collection of A (Address) records for the domain. Present when the domain has no MX record but does resolve to a web server or other host."
           }
         },
-        description: "DNS records for the email domain."
+        description: "DNS records for the email domain. Absent entirely when the domain publishes neither an MX nor an A record."
       },
       AddressObject: {
         type: "object",
@@ -47852,8 +49460,10 @@ var SPECS = {
   "dns-lookup": dns_lookup_default,
   "reverse-dns-lookup": reverse_dns_lookup_default,
   "bulk-domain-checker": bulk_domain_checker_default,
+  "domain-reputation": domain_reputation_default,
   "domain-search-with-suggestions": domain_search_with_suggestions_default,
   "domain-search": domain_search_default,
+  "domain-typosquatting": domain_typosquatting_default,
   "subdomain-lookup": subdomain_lookup_default,
   "bulk-email-validation": bulk_email_validation_default,
   "email-checker": email_checker_default,
@@ -47936,7 +49546,7 @@ var SPECS = {
   "zip-codes-by-region": zip_codes_by_region_default,
   "zip-codes-radius-search": zip_codes_radius_search_default
 };
-var SPEC_SLUGS = ["usage-credits", "commodity-fluctuation", "commodity-prices", "commodity-symbols", "commodity-time-series", "historical-commodity-prices", "currency-converter", "currency-fluctuation", "currency-historical-data-limit", "currency-rate", "currency-supported", "currency-symbols", "currency-time-series", "geolocalized-currency-conversion", "historical-currency-converter", "historical-currency-rate", "bulk-dns-lookup", "dns-history-lookup", "dns-lookup", "reverse-dns-lookup", "bulk-domain-checker", "domain-search-with-suggestions", "domain-search", "subdomain-lookup", "bulk-email-validation", "email-checker", "bulk-vat-rates-country", "financial-apis-supported-countries", "iban-validation", "swift-code-finder", "swift-code-lookup", "vat-number-validation", "vat-rates-by-ip", "vat-rates-country", "forward-geocoding", "reverse-geocoding", "administrative-units-details", "administrative-units-levels", "administrative-units", "cities", "countries-details", "countries", "flags-supported", "flags", "regions", "subregions", "bulk-ip-lookup", "bulk-ip-threat-intelligence", "ip-locator", "ip-threat-intelligence", "delete-pdf-page", "linearize-pdf", "merge-pdf", "pdf-compress", "pdf-decrypt", "pdf-encrypt", "pdf-extract-pages", "pdf-file-status", "pdf-file", "pdf-files", "pdf-generator-bulk", "pdf-generator", "pdf-resource-download", "pdf-resource-upload-binary", "pdf-resource-upload", "pdf-restrict", "pdf-task-status", "pdf-to-image", "pdf-unrestrict", "rotate-pdf-pages", "split-pdf", "bulk-phone-number-validation", "phone-validation", "web-scraper", "bulk-screenshot", "website-screenshot", "ssl-certificate-chain-lookup", "ssl-certificate-lookup", "timezone-converter", "timezone-lookup", "bulk-user-agent-parser", "user-agent-parser", "air-quality", "astronomy-data", "bulk-live-weather", "flood-forecast", "historical-weather", "live-weather", "marine-weather", "time-series-weather", "weather-forecast", "asn-lookup", "bulk-whois-lookup", "domain-whois-history-lookup", "reverse-whois", "whois-domain-lookup", "whois-ip-lookup", "bulk-zip-code-lookup", "zip-code-api", "zip-code-distance-match", "zip-code-distance", "zip-codes-by-city", "zip-codes-by-region", "zip-codes-radius-search"];
+var SPEC_SLUGS = ["usage-credits", "commodity-fluctuation", "commodity-prices", "commodity-symbols", "commodity-time-series", "historical-commodity-prices", "currency-converter", "currency-fluctuation", "currency-historical-data-limit", "currency-rate", "currency-supported", "currency-symbols", "currency-time-series", "geolocalized-currency-conversion", "historical-currency-converter", "historical-currency-rate", "bulk-dns-lookup", "dns-history-lookup", "dns-lookup", "reverse-dns-lookup", "bulk-domain-checker", "domain-reputation", "domain-search-with-suggestions", "domain-search", "domain-typosquatting", "subdomain-lookup", "bulk-email-validation", "email-checker", "bulk-vat-rates-country", "financial-apis-supported-countries", "iban-validation", "swift-code-finder", "swift-code-lookup", "vat-number-validation", "vat-rates-by-ip", "vat-rates-country", "forward-geocoding", "reverse-geocoding", "administrative-units-details", "administrative-units-levels", "administrative-units", "cities", "countries-details", "countries", "flags-supported", "flags", "regions", "subregions", "bulk-ip-lookup", "bulk-ip-threat-intelligence", "ip-locator", "ip-threat-intelligence", "delete-pdf-page", "linearize-pdf", "merge-pdf", "pdf-compress", "pdf-decrypt", "pdf-encrypt", "pdf-extract-pages", "pdf-file-status", "pdf-file", "pdf-files", "pdf-generator-bulk", "pdf-generator", "pdf-resource-download", "pdf-resource-upload-binary", "pdf-resource-upload", "pdf-restrict", "pdf-task-status", "pdf-to-image", "pdf-unrestrict", "rotate-pdf-pages", "split-pdf", "bulk-phone-number-validation", "phone-validation", "web-scraper", "bulk-screenshot", "website-screenshot", "ssl-certificate-chain-lookup", "ssl-certificate-lookup", "timezone-converter", "timezone-lookup", "bulk-user-agent-parser", "user-agent-parser", "air-quality", "astronomy-data", "bulk-live-weather", "flood-forecast", "historical-weather", "live-weather", "marine-weather", "time-series-weather", "weather-forecast", "asn-lookup", "bulk-whois-lookup", "domain-whois-history-lookup", "reverse-whois", "whois-domain-lookup", "whois-ip-lookup", "bulk-zip-code-lookup", "zip-code-api", "zip-code-distance-match", "zip-code-distance", "zip-codes-by-city", "zip-codes-by-region", "zip-codes-radius-search"];
 var SPECS_YAML = {
   "usage-credits": "openapi: 3.1.1\ninfo:\n  title: Credits Usage API\n  version: 1.0.0\n  description: Retrieve the remaining and consumed API credit balances for the authenticated organization. Returns subscription-plan credits, subscription surcharge (overage) credits, and one-off credit purchases as separate balances, each with allowed and used counts. Only an organization admin API key can call this endpoint; all other keys receive a 403. There are no optional data modules for this endpoint \u2014 the response always includes the full credit breakdown.\n  contact:\n    name: APIFreaks Support\n    url: https://apifreaks.com/contact\n    email: support@apifreaks.com\nservers:\n  - url: https://api.apifreaks.com/v1.0\n    description: Credits Usage API Server\npaths:\n  /credits/usage/info:\n    get:\n      tags:\n        - General APIs\n      summary: Get remaining and consumed API credit balances for the organization\n      description: Returns subscription, subscription-surcharge, and one-off credit balances for the authenticated organization's account.\n      operationId: getCreditsUsage\n      parameters:\n        - name: format\n          in: query\n          required: false\n          description: 'Format of the response. Possible values: json, xml.'\n          schema:\n            type: string\n            enum:\n              - json\n              - xml\n            default: json\n      responses:\n        '200':\n          description: Successful response with credit balances\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/CreditsUsageResponse'\n              examples:\n                success:\n                  summary: Typical response\n                  value:\n                    apiKey: demo\n                    userStatus: active\n                    subActive: true\n                    subStatus: active\n                    subAllowedCredits: 10000\n                    subUsedCredits: 2500\n                    subSurchargeStatus: none\n                    subSurchargeAllowedCredits: 0\n                    subSurchargeUsedCredits: 0\n                    subSurchargeAllowed: false\n                    oneOffCreditsActive: true\n                    oneOffAllowedCredits: 5000\n                    oneOffUsedCredits: 1000\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n        '403':\n          description: Forbidden \u2014 Caller is not an organization admin\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                notOrgAdmin:\n                  summary: Not an organization admin\n                  value:\n                    timestamp: '2026-07-27T10:23:16.548Z'\n                    path: /v1.0/credits/usage/info\n                    status: 403\n                    error: API Access Exception\n                    message: You need to be organization admin to access this endpoint.\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\ncomponents:\n  securitySchemes:\n    ApiKeyAuthHeader:\n      type: apiKey\n      in: header\n      name: X-apiKey\n      description: Pass your API key via the X-apiKey request header.\n    ApiKeyAuthQuery:\n      type: apiKey\n      in: query\n      name: apiKey\n      description: Pass your API key via the apiKey query parameter.\n  schemas:\n    CreditsUsageResponse:\n      type: object\n      description: Credit balances for the organization's subscription, subscription surcharge, and one-off purchases.\n      required:\n        - apiKey\n        - userStatus\n        - oneOffCreditsActive\n        - oneOffAllowedCredits\n        - oneOffUsedCredits\n      properties:\n        apiKey:\n          type: string\n          description: The API key the credit balances belong to.\n        userStatus:\n          type: string\n          enum:\n            - active\n            - inactive\n            - deleted\n          description: Status of the user account.\n        subActive:\n          type:\n            - boolean\n            - 'null'\n          description: Whether a subscription plan is currently active. Null if the account has no subscription.\n        subStatus:\n          type:\n            - string\n            - 'null'\n          enum:\n            - active\n            - overdue\n            - cancelled\n            - deactivated\n            - null\n          description: Status of the subscription credits. Null if the account has no subscription.\n        subAllowedCredits:\n          type:\n            - integer\n            - 'null'\n          description: Total credits allowed under the subscription plan. Null if the account has no subscription.\n        subUsedCredits:\n          type:\n            - integer\n            - 'null'\n          description: Credits consumed under the subscription plan. Null if the account has no subscription.\n        subSurchargeStatus:\n          type:\n            - string\n            - 'null'\n          enum:\n            - none\n            - payment_added\n            - payment_cleared\n            - null\n          description: Status of the subscription surcharge (overage) credits. Null if the account has no subscription.\n        subSurchargeAllowedCredits:\n          type:\n            - integer\n            - 'null'\n          description: Total surcharge credits allowed. Null if the account has no subscription.\n        subSurchargeUsedCredits:\n          type:\n            - integer\n            - 'null'\n          description: Surcharge credits consumed. Null if the account has no subscription.\n        subSurchargeAllowed:\n          type:\n            - boolean\n            - 'null'\n          description: Whether surcharge (overage) usage is allowed on the subscription. Null if the account has no subscription.\n        oneOffCreditsActive:\n          type: boolean\n          description: Whether the account has active one-off (pay-as-you-go) credits.\n        oneOffAllowedCredits:\n          type: integer\n          description: Total one-off credits purchased.\n        oneOffUsedCredits:\n          type: integer\n          description: One-off credits consumed.\n    ErrorResponse:\n      type: object\n      description: Standard error envelope returned by the API on failed requests.\n      required:\n        - message\n      properties:\n        error:\n          type: string\n          description: Short error category or exception type.\n        message:\n          type: string\n          description: Human-readable error message describing the failure.\n        path:\n          type: string\n          description: API endpoint path that produced the error.\n        status:\n          type: integer\n          description: HTTP status code returned with the error.\n        timestamp:\n          type: string\n          format: date-time\n          description: Timestamp when the error occurred (ISO 8601).\n  headers:\n    X-AF-Credits-Cost:\n      description: Specifies the number of credits consumed by the current request.\n      schema:\n        type: integer\nsecurity:\n  - ApiKeyAuthHeader: []\n  - ApiKeyAuthQuery: []\n",
   "commodity-fluctuation": "openapi: 3.1.1\ninfo:\n  title: 'Commodity Fluctuation API '\n  version: 1.0.0\n  description: Calculate price change and percentage movement for any commodity over a custom date range. Returns the opening price, closing price, absolute change, and percentage change for each symbol. Accepts one or more comma-separated commodity symbols with a start and end date in YYYY-MM-DD format. Returns a 400 error for invalid dates or a date range where start is after end, and a 404 error for unsupported symbols or a date range with no available data.\n  contact:\n    name: APIFreaks Support\n    url: https://apifreaks.com/contact\n    email: support@apifreaks.com\nservers:\n  - url: https://api.apifreaks.com/v1.0\n    description: Commodity Fluctuation API Server\npaths:\n  /commodity/fluctuation:\n    get:\n      tags:\n        - Commodity APIs\n      summary: Get commodity price fluctuations\n      description: Returns price fluctuation metrics (start, end, change, percent change) for the requested commodity symbols over a date range.\n      operationId: getCommodityFluctuation\n      parameters:\n        - name: format\n          in: query\n          required: false\n          description: Response format. Currently only `json` is supported.\n          schema:\n            type: string\n            default: json\n            enum:\n              - json\n        - name: symbols\n          in: query\n          required: true\n          description: Comma-separated list of commodity symbols.\n          schema:\n            type: string\n        - name: startDate\n          in: query\n          required: true\n          description: Start date in `YYYY-MM-DD` format.\n          schema:\n            type: string\n        - name: endDate\n          in: query\n          required: true\n          description: End date in `YYYY-MM-DD` format.\n          schema:\n            type: string\n      responses:\n        '200':\n          description: Successful operation\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/CommodityFluctuationResponse'\n              examples:\n                success:\n                  summary: Successful response\n                  value:\n                    success: true\n                    startDate: '2024-01-01'\n                    endDate: '2024-01-31'\n                    rates:\n                      WTIOIL-SPOT:\n                        startRate: 72.02\n                        endRate: 75.81\n                        change: 3.79\n                        changePercent: 5.26\n                      XAU:\n                        startRate: 2063.63\n                        endRate: 2039.83\n                        change: -23.8\n                        changePercent: -1.15\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n        '400':\n          description: Bad Request \u2014 Missing parameters or invalid dates\n          content:\n            application/json:\n              examples:\n                missingSymbols:\n                  summary: Missing required symbols parameter\n                  value:\n                    error: Invalid Param Exception\n                    message: please pass correct parameters\n                    path: /v1.0/commodity/fluctuation\n                    status: 400\n                    timestamp: '2026-07-27T11:37:24.273Z'\n                invalidDateFormat:\n                  summary: Date is not in YYYY-MM-DD format\n                  value:\n                    timestamp: '2026-07-27T11:37:22.687Z'\n                    path: /rates/fluctuation\n                    code: 400\n                    error: VALIDATION_ERROR\n                    message: Invalid Date Format (YYYY-MM-DD).\n                dateNotExist:\n                  summary: Date does not exist on the calendar (e.g. Feb 30)\n                  value:\n                    timestamp: '2026-07-27T11:37:33.565Z'\n                    path: /rates/fluctuation\n                    code: 400\n                    error: VALIDATION_ERROR\n                    message: 'Invalid Date: The provided start date or end date does not exist.'\n                startAfterEnd:\n                  summary: startDate is after endDate\n                  value:\n                    timestamp: '2026-07-27T11:37:23.206Z'\n                    path: /rates/fluctuation\n                    code: 400\n                    error: VALIDATION_ERROR\n                    message: Start date cannot be after end date\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n        '404':\n          description: Not found - Symbol or data not available\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                symbolNotFound:\n                  summary: Symbol Not Found\n                  value:\n                    timestamp: '2026-07-27T11:37:23.759Z'\n                    path: /rates/fluctuation\n                    code: 404\n                    error: SYMBOL_NOT_FOUND\n                    message: The symbol is not supported, please visit the documentation for a list of supported symbols\n                noData:\n                  summary: No data available for the given date range\n                  value:\n                    timestamp: '2026-07-27T11:37:34.167Z'\n                    path: /rates/fluctuation\n                    code: 404\n                    error: DATA_NOT_FOUND\n                    message: No data found for the given date range\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\ncomponents:\n  securitySchemes:\n    ApiKeyAuthHeader:\n      type: apiKey\n      in: header\n      name: X-apiKey\n      description: Pass your API key via the X-apiKey request header.\n    ApiKeyAuthQuery:\n      type: apiKey\n      in: query\n      name: apiKey\n      description: Pass your API key via the apiKey query parameter.\n  schemas:\n    CommodityFluctuationResponse:\n      type: object\n      required:\n        - success\n        - startDate\n        - endDate\n        - rates\n      properties:\n        success:\n          type: boolean\n          description: '`true` for successful requests.'\n        startDate:\n          type: string\n          description: Start date of the interval (YYYY-MM-DD).\n        endDate:\n          type: string\n          description: End date of the interval (YYYY-MM-DD).\n        rates:\n          $ref: '#/components/schemas/CommodityFluctuationRates'\n      description: Commodity fluctuation response containing price change data per symbol over a date range.\n    CommodityFluctuationRates:\n      type: object\n      description: Map of requested commodity symbols to their fluctuation metrics. Each key is a commodity symbol (e.g. XAU).\n      additionalProperties:\n        title: CommodityFluctuationItem\n        type: object\n        description: Fluctuation metrics for a single commodity over a date range.\n        required:\n          - startRate\n          - endRate\n          - change\n          - changePercent\n        properties:\n          startRate:\n            type: number\n            format: float\n            description: Price of the commodity on the start date.\n          endRate:\n            type: number\n            format: float\n            description: Price of the commodity on the end date.\n          change:\n            type: number\n            format: float\n            description: Absolute price difference between end and start dates. May be negative.\n          changePercent:\n            type: number\n            format: float\n            description: Percentage price change from start to end date. May be negative.\n    ErrorResponse:\n      type: object\n      description: Standard error envelope returned by the API on failed requests. Gateway-level validation errors populate status; commodity-service errors (date/symbol/data validation) populate code instead \u2014 check whichever is present.\n      required:\n        - message\n      properties:\n        error:\n          type: string\n          description: Short error category or exception type (e.g., Invalid Param Exception, VALIDATION_ERROR, SYMBOL_NOT_FOUND, DATA_NOT_FOUND).\n        message:\n          type: string\n          description: Human-readable error message describing the failure.\n        path:\n          type: string\n          description: API endpoint path (gateway errors) or internal service path (commodity-service errors) that produced the error.\n        status:\n          type: integer\n          description: HTTP status code. Present on gateway-level errors.\n        code:\n          type: integer\n          description: HTTP status code. Present on commodity-service errors instead of status.\n        timestamp:\n          type: string\n          format: date-time\n          description: Timestamp when the error occurred (ISO 8601).\n  headers:\n    X-AF-Credits-Cost:\n      description: Specifies the number of credits consumed by the current request.\n      schema:\n        type: integer\nsecurity:\n  - ApiKeyAuthHeader: []\n  - ApiKeyAuthQuery: []\n",
@@ -49879,6 +51489,905 @@ components:
 security:
   - ApiKeyAuthHeader: []
   - ApiKeyAuthQuery: []
+`,
+  "domain-reputation": `openapi: 3.1.1
+info:
+  title: Domain Reputation API - Real-Time Risk Verdict, Trust Score, DGA Detection, and Threat Intelligence for Any Domain
+  version: 1.0.0
+  description: Assess any domain and get a synthesized risk verdict, a weighted trust score, DGA detection, threat intelligence matches, and a full email deliverability check in one call. Every score carries the evidence behind it, and partial data is called out in errors rather than silently dropped. Built for fraud screening, phishing triage, email vetting, brand protection, and threat intel enrichment.
+  contact:
+    name: APIFreaks Support
+    url: https://apifreaks.com/contact
+    email: support@apifreaks.com
+servers:
+  - url: https://api.apifreaks.com/v1.0
+    description: Domain Reputation API Server
+paths:
+  /domain/reputation:
+    get:
+      tags:
+        - Domain APIs
+      summary: Get a real-time risk verdict, trust score, and threat intelligence for any domain.
+      description: The Domain Reputation API assesses a domain and returns a risk verdict, trust score, DGA detection results, threat intelligence matches, email deliverability analysis, and evidence summary. Partial data is flagged in the errors array rather than silently dropped.
+      parameters:
+        - name: format
+          in: query
+          required: false
+          schema:
+            type: string
+            enum:
+              - json
+              - xml
+            default: json
+          description: Format of the response.
+        - name: domainName
+          in: query
+          required: true
+          schema:
+            type: string
+          description: The domain name to assess (e.g. example.com). Must contain at least one dot and be at most 253 characters. Automatically lowercased.
+      responses:
+        '200':
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DomainReputationResponse'
+              examples:
+                success:
+                  summary: Safe domain (apple.com)
+                  value:
+                    input:
+                      domain: apple.com
+                    assessed_at: '2026-09-08T08:36:23.820181075Z'
+                    version: 1.0.0
+                    processing_time_ms: 1739
+                    risk_category:
+                      verdict: safe
+                      confidence: 0.8
+                      primary_threat: null
+                      severity: none
+                      threat_types: []
+                      sources: []
+                      pivot_matches: []
+                    dga_score:
+                      score: 0
+                      is_dga: false
+                      model: deterministic_features_v1
+                      features:
+                        domain_length: 5
+                        vowel_consonant_ratio: 0.6666666666666666
+                        ngram_perplexity: -8.83
+                        shannon_entropy: 1.9219280948873623
+                        digit_letter_ratio: 0
+                        consonant_streak_max: 3
+                        tld_in_known_dga_set: false
+                      interpretation: human_readable
+                    trust_signals:
+                      trust_score: 72
+                      trust_band: high
+                      signals:
+                        positive:
+                          - code: spf_configured
+                            weight: 5
+                            polarity: positive
+                            category: email_security
+                            evidence: SPF record found
+                            confidence: 1
+                          - code: dmarc_present
+                            weight: 5
+                            polarity: positive
+                            category: email_security
+                            evidence: DMARC record present
+                            confidence: 1
+                          - code: established_domain
+                            weight: 10
+                            polarity: positive
+                            category: domain_age
+                            evidence: Domain age > 2 years
+                            confidence: 1
+                          - code: mature_domain
+                            weight: 5
+                            polarity: positive
+                            category: domain_age
+                            evidence: Domain age > 5 years
+                            confidence: 1
+                          - code: paid_ssl
+                            weight: 5
+                            polarity: positive
+                            category: ssl_certificate
+                            evidence: Uses paid SSL certificate
+                            confidence: 0.9
+                          - code: valid_ssl
+                            weight: 3
+                            polarity: positive
+                            category: ssl_certificate
+                            evidence: Valid SSL certificate
+                            confidence: 1
+                        negative:
+                          - code: privacy_whois
+                            weight: 1
+                            polarity: negative
+                            category: whois_privacy
+                            evidence: WHOIS information is privacy-protected
+                            confidence: 0.9
+                          - code: external_redirect
+                            weight: 10
+                            polarity: negative
+                            category: content_analysis
+                            evidence: Site redirects visitors to an external domain
+                            confidence: 0.8
+                        neutral: []
+                      indicators:
+                        is_newly_registered: false
+                        uses_free_extension: false
+                        uses_free_ssl: false
+                        has_privacy_whois: true
+                        ssl_age_days: 26
+                        has_dmarc: true
+                        has_spf: true
+                        redirects_externally: true
+                        javascript_obfuscated: false
+                        domain_age_days: 14446
+                        registrar: NOM-IQ Ltd dba Com Laude
+                    email_deliverability:
+                      score: 95
+                      grade: excellent
+                      can_receive_email: true
+                      authentication:
+                        spf:
+                          present: true
+                          policy: ~all
+                          record: v=spf1 include:_spf.apple.com include:_spf-txn.apple.com ~all
+                        dkim:
+                          found: true
+                          selectors_found:
+                            - selector1
+                            - selector2
+                          providers_detected: []
+                          note: Only common selectors are probed; a domain may use a custom selector
+                        dmarc:
+                          present: true
+                          policy: quarantine
+                          reporting_configured: true
+                      infrastructure:
+                        mx_count: 6
+                        mx_records:
+                          - mx-in-ma.apple.com.
+                          - mx-in.g.apple.com.
+                          - mx-in-rn.apple.com.
+                          - mx-in-sg.apple.com.
+                          - mx-in-hfd.apple.com.
+                          - mx-in-vib.apple.com.
+                        mx_provider: self_hosted
+                        null_mx: false
+                      reputation:
+                        spam_blacklisted: false
+                        newly_registered: false
+                        domain_age_days: 14446
+                      issues:
+                        - code: spf_softfail
+                          severity: low
+                          message: The SPF policy '~all' only soft-fails unauthorized senders
+                          recommendation: Move to '-all' once all legitimate sending sources are listed
+                    intelligence:
+                      ioc_type: domain
+                      ioc_value: apple.com
+                      related_iocs:
+                        - type: ipv4
+                          value: 17.253.144.10
+                          confidence: 0.9
+                        - type: ipv6
+                          value: 2620:149:af0:0:0:0:0:10
+                          confidence: 0.9
+                      feed_tags:
+                        - verdict:safe
+                        - severity:none
+                        - ns:d.ns.apple.com.
+                        - ns:b.ns.apple.com.
+                        - ns:c.ns.apple.com.
+                        - ns:a.ns.apple.com.
+                        - mx:mx-in-ma.apple.com.
+                        - mx:mx-in.g.apple.com.
+                        - mx:mx-in-rn.apple.com.
+                        - mx:mx-in-sg.apple.com.
+                        - mx:mx-in-hfd.apple.com.
+                        - mx:mx-in-vib.apple.com.
+                      stix_pattern: '[domain-name:value = ''apple.com'' OR ipv4-addr:value = ''17.253.144.10'' OR ipv6-addr:value = ''2620:149:af0:0:0:0:0:10'']'
+                      recommended_action: allow
+                      first_seen: null
+                      last_seen: null
+                    evidence_summary:
+                      why_flagged: []
+                    errors: []
+                partialData:
+                  summary: Partial data (WHOIS lookup failed)
+                  value:
+                    input:
+                      domain: apifreaks.com
+                    risk_category:
+                      verdict: safe
+                      confidence: 0.7
+                      severity: none
+                    trust_signals:
+                      trust_score: 70
+                      trust_band: high
+                      indicators:
+                        is_newly_registered: null
+                        has_privacy_whois: null
+                        domain_age_days: null
+                        registrar: null
+                    errors:
+                      - WHOIS lookup failed
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
+        '400':
+          description: Bad Request \u2013 Invalid or missing domainName parameter
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+              examples:
+                invalidDomain:
+                  summary: Invalid domain parameter
+                  value:
+                    error: Invalid Domain Exception
+                    message: Please provide a valid domain name in the "domainName" parameter.
+                    path: /v1.0/domain/reputation
+                    status: 400
+                    timestamp: '2026-09-08T12:00:00.000Z'
+                missingDomain:
+                  summary: Missing domainName parameter
+                  value:
+                    error: Invalid Param Exception
+                    message: Please provide a valid domain name in the "domainName" parameter.
+                    path: /v1.0/domain/reputation
+                    status: 400
+                    timestamp: '2026-09-08T12:00:00.000Z'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
+        '503':
+          description: Service Unavailable \u2013 The assessment service is temporarily unavailable
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+              examples:
+                serviceUnavailable:
+                  summary: Service Unavailable
+                  value:
+                    error: Service Unavailable
+                    message: 'Service is unavailable. Please try after some time. [For Technical Support email at: support@apifreaks.com]'
+                    path: /v1.0/domain/reputation
+                    status: 503
+                    timestamp: '2026-09-08T12:00:00.000Z'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
+      operationId: getDomainReputation
+components:
+  securitySchemes:
+    ApiKeyAuthHeader:
+      type: apiKey
+      in: header
+      name: X-apiKey
+      description: Pass your API key via the X-apiKey request header.
+    ApiKeyAuthQuery:
+      type: apiKey
+      in: query
+      name: apiKey
+      description: Pass your API key via the apiKey query parameter.
+  schemas:
+    DomainReputationResponse:
+      type: object
+      required:
+        - input
+        - assessed_at
+        - version
+        - processing_time_ms
+        - risk_category
+        - dga_score
+        - trust_signals
+        - email_deliverability
+        - intelligence
+        - evidence_summary
+        - errors
+      properties:
+        input:
+          type: object
+          required:
+            - domain
+          properties:
+            domain:
+              type: string
+              description: Domain name being analyzed.
+          description: Input object containing the analyzed domain.
+        assessed_at:
+          type: string
+          description: Timestamp when the assessment was performed (YYYY-MM-DDTHH:mm:ssZ).
+        version:
+          type: string
+          description: API / response schema version.
+        processing_time_ms:
+          type: integer
+          description: Time taken to process the request, in milliseconds.
+        risk_category:
+          $ref: '#/components/schemas/RiskCategory'
+        dga_score:
+          $ref: '#/components/schemas/DgaScore'
+        trust_signals:
+          $ref: '#/components/schemas/TrustSignals'
+        email_deliverability:
+          $ref: '#/components/schemas/EmailDeliverability'
+        intelligence:
+          $ref: '#/components/schemas/Intelligence'
+        evidence_summary:
+          $ref: '#/components/schemas/EvidenceSummary'
+        errors:
+          type: array
+          items:
+            type: string
+          description: List of errors encountered during processing, if any (e.g. "WHOIS lookup failed"). An empty array means every signal resolved.
+      description: Full domain reputation assessment response.
+    RiskCategory:
+      type: object
+      required:
+        - verdict
+        - confidence
+        - primary_threat
+        - severity
+        - threat_types
+        - sources
+        - pivot_matches
+      properties:
+        verdict:
+          type: string
+          enum:
+            - safe
+            - suspicious
+          description: Final verdict of the risk assessment.
+        confidence:
+          type: number
+          format: float
+          description: Confidence score for the verdict (0-1).
+        primary_threat:
+          type:
+            - string
+            - 'null'
+          description: Main threat type identified (e.g. phishing). null when no threat was identified.
+        severity:
+          type: string
+          enum:
+            - none
+            - low
+            - medium
+            - high
+          description: Severity level of the risk.
+        threat_types:
+          type: array
+          items:
+            type: string
+          description: List of threat types associated with the domain.
+        sources:
+          type: array
+          items:
+            $ref: '#/components/schemas/ThreatSource'
+          description: Threat intelligence sources that flagged the domain. Empty when nothing flagged it.
+        pivot_matches:
+          type: array
+          items:
+            $ref: '#/components/schemas/PivotMatch'
+          description: Related pivots (nameserver, email, etc.) linked to known threats.
+      description: Overall risk assessment for the domain.
+    ThreatSource:
+      type: object
+      required:
+        - source
+        - indicator
+        - threat_type
+        - confidence
+        - first_seen
+        - last_seen
+      properties:
+        source:
+          type: string
+          description: Name of the threat intelligence source (e.g. Spamhaus).
+        indicator:
+          type: string
+          description: Indicator matched by this source.
+        threat_type:
+          type: string
+          description: Threat type reported by this source.
+        confidence:
+          type: number
+          format: float
+          description: Confidence score from this source (0-1).
+        first_seen:
+          type: string
+          description: First time this indicator was seen by the source (YYYY-MM-DDTHH:mm:ssZ).
+        last_seen:
+          type: string
+          description: Last time this indicator was seen by the source (YYYY-MM-DDTHH:mm:ssZ).
+      description: A threat intelligence source that flagged the domain.
+    PivotMatch:
+      type: object
+      required:
+        - pivot
+        - pivot_type
+        - total_related_threats
+        - confidence
+      properties:
+        pivot:
+          type: string
+          description: Pivot value (e.g. a nameserver or email address).
+        pivot_type:
+          type: string
+          description: Type of pivot.
+        total_related_threats:
+          type: integer
+          description: Total number of threats related to this pivot.
+        confidence:
+          type: number
+          format: float
+          description: Confidence score for the pivot match (0-1).
+      description: A related pivot linked to known threats.
+    DgaScore:
+      type: object
+      required:
+        - score
+        - is_dga
+        - model
+        - features
+        - interpretation
+      properties:
+        score:
+          type: number
+          format: float
+          description: DGA likelihood score (0-1).
+        is_dga:
+          type: boolean
+          description: Indicates whether the domain is likely DGA-generated.
+        model:
+          type: string
+          description: Model used to compute the DGA score.
+        features:
+          $ref: '#/components/schemas/DgaFeatures'
+        interpretation:
+          type: string
+          description: Human-readable interpretation of the DGA score.
+      description: Domain Generation Algorithm (DGA) detection results.
+    DgaFeatures:
+      type: object
+      required:
+        - domain_length
+        - vowel_consonant_ratio
+        - ngram_perplexity
+        - shannon_entropy
+        - digit_letter_ratio
+        - consonant_streak_max
+        - tld_in_known_dga_set
+      properties:
+        domain_length:
+          type: integer
+          description: Length of the domain name.
+        vowel_consonant_ratio:
+          type: number
+          format: float
+          description: Ratio of vowels to consonants in the domain.
+        ngram_perplexity:
+          type: number
+          format: float
+          description: N-gram perplexity score of the domain string.
+        shannon_entropy:
+          type: number
+          format: float
+          description: Shannon entropy of the domain string.
+        digit_letter_ratio:
+          type: number
+          format: float
+          description: Ratio of digits to letters in the domain.
+        consonant_streak_max:
+          type: integer
+          description: Maximum consecutive consonant streak in the domain.
+        tld_in_known_dga_set:
+          type: boolean
+          description: Indicates if the TLD belongs to a known DGA set.
+      description: Underlying lexical / statistical features used in DGA detection.
+    TrustSignals:
+      type: object
+      required:
+        - trust_score
+        - trust_band
+        - signals
+        - indicators
+      properties:
+        trust_score:
+          type: integer
+          description: Overall trust score (0-100).
+        trust_band:
+          type: string
+          description: Trust score band / category (e.g. low, medium, high).
+        signals:
+          $ref: '#/components/schemas/TrustScoreSignals'
+        indicators:
+          $ref: '#/components/schemas/TrustIndicators'
+      description: Trust scoring and supporting signals for the domain.
+    TrustScoreSignals:
+      type: object
+      required:
+        - positive
+        - negative
+        - neutral
+      properties:
+        positive:
+          type: array
+          items:
+            $ref: '#/components/schemas/TrustSignalItem'
+          description: Signals that positively affect the trust score.
+        negative:
+          type: array
+          items:
+            $ref: '#/components/schemas/TrustSignalItem'
+          description: Signals that negatively affect the trust score.
+        neutral:
+          type: array
+          items:
+            $ref: '#/components/schemas/TrustSignalItem'
+          description: Signals that are neutral to the trust score.
+      description: Signals contributing to the trust score.
+    TrustSignalItem:
+      type: object
+      required:
+        - code
+        - weight
+        - polarity
+        - category
+        - evidence
+        - confidence
+      properties:
+        code:
+          type: string
+          description: Signal code identifier (e.g. valid_ssl, dmarc_missing).
+        weight:
+          type: integer
+          description: Weight assigned to the signal.
+        polarity:
+          type: string
+          enum:
+            - positive
+            - negative
+            - neutral
+          description: Polarity of the signal.
+        category:
+          type: string
+          description: Category the signal belongs to (e.g. ssl_certificate).
+        evidence:
+          type: string
+          description: Evidence supporting the signal.
+        confidence:
+          type: number
+          format: float
+          description: Confidence score for the signal (0-1).
+      description: A single trust signal contributing to the trust score.
+    TrustIndicators:
+      type: object
+      properties:
+        is_newly_registered:
+          type:
+            - boolean
+            - 'null'
+          description: Indicates whether the domain was recently registered. null when WHOIS data is unavailable.
+        uses_free_extension:
+          type: boolean
+          description: Indicates whether the domain uses a free TLD extension.
+        uses_free_ssl:
+          type: boolean
+          description: Indicates whether the domain uses a free SSL certificate.
+        has_privacy_whois:
+          type:
+            - boolean
+            - 'null'
+          description: Indicates whether WHOIS privacy protection is enabled. null when WHOIS data is unavailable.
+        ssl_age_days:
+          type:
+            - integer
+            - 'null'
+          description: Age of the SSL certificate in days.
+        has_dmarc:
+          type: boolean
+          description: Indicates whether a DMARC record exists.
+        has_spf:
+          type: boolean
+          description: Indicates whether an SPF record exists.
+        redirects_externally:
+          type: boolean
+          description: Indicates whether the domain redirects to an external site.
+        javascript_obfuscated:
+          type: boolean
+          description: Indicates whether obfuscated JavaScript was detected.
+        domain_age_days:
+          type:
+            - integer
+            - 'null'
+          description: Age of the domain in days. null when WHOIS data is unavailable.
+        registrar:
+          type:
+            - string
+            - 'null'
+          description: Domain registrar name. null when WHOIS data is unavailable.
+      description: Individual trust / risk indicators for the domain.
+    EmailDeliverability:
+      type: object
+      required:
+        - score
+        - grade
+        - can_receive_email
+        - authentication
+        - infrastructure
+        - reputation
+        - issues
+      properties:
+        score:
+          type: integer
+          description: Overall email deliverability score out of 100.
+        grade:
+          type: string
+          description: Letter / word grade summarizing the deliverability score.
+        can_receive_email:
+          type: boolean
+          description: Indicates whether the domain is configured to receive email.
+        authentication:
+          $ref: '#/components/schemas/EmailAuthentication'
+        infrastructure:
+          $ref: '#/components/schemas/EmailInfrastructure'
+        reputation:
+          $ref: '#/components/schemas/EmailReputation'
+        issues:
+          type: array
+          items:
+            $ref: '#/components/schemas/EmailIssue'
+          description: List of detected email deliverability issues or misconfigurations.
+      description: Assessment of the domain's ability to send and receive email reliably.
+    EmailAuthentication:
+      type: object
+      required:
+        - spf
+        - dkim
+        - dmarc
+      properties:
+        spf:
+          $ref: '#/components/schemas/SpfRecord'
+        dkim:
+          $ref: '#/components/schemas/DkimRecord'
+        dmarc:
+          $ref: '#/components/schemas/DmarcRecord'
+      description: Email authentication mechanisms configured for the domain.
+    SpfRecord:
+      type: object
+      required:
+        - present
+        - policy
+        - record
+      properties:
+        present:
+          type: boolean
+          description: Indicates whether an SPF record was found.
+        policy:
+          type: string
+          description: SPF enforcement policy qualifier found in the record (e.g. ~all, -all).
+        record:
+          type: string
+          description: Raw SPF DNS TXT record string.
+      description: Sender Policy Framework configuration.
+    DkimRecord:
+      type: object
+      required:
+        - found
+        - selectors_found
+        - providers_detected
+        - note
+      properties:
+        found:
+          type: boolean
+          description: Indicates whether a DKIM record was found for any probed selector.
+        selectors_found:
+          type: array
+          items:
+            type: string
+          description: List of DKIM selectors for which a record was found.
+        providers_detected:
+          type: array
+          items:
+            type: string
+          description: Email service providers inferred from the matched DKIM selectors.
+        note:
+          type: string
+          description: Clarifying note about the limitations of DKIM selector probing.
+      description: DomainKeys Identified Mail configuration.
+    DmarcRecord:
+      type: object
+      required:
+        - present
+        - policy
+        - reporting_configured
+      properties:
+        present:
+          type: boolean
+          description: Indicates whether a DMARC record was found.
+        policy:
+          type: string
+          description: DMARC enforcement policy applied to failing messages (e.g. none, quarantine, reject).
+        reporting_configured:
+          type: boolean
+          description: Indicates whether DMARC aggregate / forensic reporting addresses are configured.
+      description: Domain-based Message Authentication, Reporting and Conformance configuration.
+    EmailInfrastructure:
+      type: object
+      required:
+        - mx_count
+        - mx_records
+        - mx_provider
+        - null_mx
+      properties:
+        mx_count:
+          type: integer
+          description: Number of MX records found for the domain.
+        mx_records:
+          type: array
+          items:
+            type: string
+          description: List of mail exchange server hostnames for the domain.
+        mx_provider:
+          type: string
+          description: Email hosting provider inferred from the MX records.
+        null_mx:
+          type: boolean
+          description: Indicates whether the domain explicitly declines email via a null MX record.
+      description: Mail server infrastructure backing the domain.
+    EmailReputation:
+      type: object
+      required:
+        - spam_blacklisted
+        - newly_registered
+      properties:
+        spam_blacklisted:
+          type: boolean
+          description: Indicates whether the domain appears on known spam blacklists.
+        newly_registered:
+          type: boolean
+          description: Indicates whether the domain was registered recently.
+        domain_age_days:
+          type:
+            - integer
+            - 'null'
+          description: Age of the domain in days since registration.
+      description: Reputation and trust signals related to the domain's email sending history.
+    EmailIssue:
+      type: object
+      properties:
+        code:
+          type: string
+          description: Machine-readable code identifying the specific deliverability issue.
+        severity:
+          type: string
+          description: Severity level assigned to the detected issue.
+        message:
+          type: string
+          description: Human-readable explanation of the issue.
+        recommendation:
+          type: string
+          description: Plain-language description of the exact fix to apply.
+      description: A detected email deliverability issue or misconfiguration.
+    Intelligence:
+      type: object
+      required:
+        - ioc_type
+        - ioc_value
+        - related_iocs
+        - feed_tags
+        - stix_pattern
+        - recommended_action
+        - first_seen
+        - last_seen
+      properties:
+        ioc_type:
+          type: string
+          description: Type of the indicator of compromise (e.g. domain).
+        ioc_value:
+          type: string
+          description: Value of the indicator of compromise.
+        related_iocs:
+          type: array
+          items:
+            $ref: '#/components/schemas/RelatedIoc'
+          description: Other IOCs related to this domain.
+        feed_tags:
+          type: array
+          items:
+            type: string
+          description: Tags associated with this IOC from threat feeds.
+        stix_pattern:
+          type: string
+          description: STIX 2.1 pattern representation of the IOC, ready to wrap into an Indicator object.
+        recommended_action:
+          type: string
+          enum:
+            - allow
+            - monitor
+            - block
+          description: Recommended action based on the assessment.
+        first_seen:
+          type:
+            - string
+            - 'null'
+          description: First time this IOC was observed (YYYY-MM-DDTHH:mm:ssZ). null when never observed on a feed.
+        last_seen:
+          type:
+            - string
+            - 'null'
+          description: Last time this IOC was observed (YYYY-MM-DDTHH:mm:ssZ). null when never observed on a feed.
+      description: Threat intelligence details for the indicator of compromise (IOC).
+    RelatedIoc:
+      type: object
+      required:
+        - type
+        - value
+        - confidence
+      properties:
+        type:
+          type: string
+          description: Type of the related IOC (e.g. ipv4, ipv6).
+        value:
+          type: string
+          description: Value of the related IOC.
+        confidence:
+          type: number
+          format: float
+          description: Confidence score for the related IOC (0-1).
+      description: A related indicator of compromise.
+    EvidenceSummary:
+      type: object
+      required:
+        - why_flagged
+      properties:
+        why_flagged:
+          type: array
+          items:
+            type: string
+          description: List of reasons why the domain was flagged. Empty for a clean domain.
+      description: Summary of reasons behind the risk assessment.
+    ErrorResponse:
+      type: object
+      description: Standard error envelope returned by the API on failed requests.
+      required:
+        - message
+      properties:
+        error:
+          type: string
+          description: Short error category or exception type.
+        message:
+          type: string
+          description: Human-readable error message describing the failure.
+        path:
+          type: string
+          description: API endpoint path that produced the error.
+        status:
+          type: integer
+          description: HTTP status code returned with the error.
+        timestamp:
+          type: string
+          format: date-time
+          description: Timestamp when the error occurred (ISO 8601).
+  headers:
+    X-AF-Credits-Cost:
+      description: Specifies the number of credits consumed by the current request.
+      schema:
+        type: integer
+security:
+  - ApiKeyAuthHeader: []
+  - ApiKeyAuthQuery: []
 `,
   "domain-search-with-suggestions": `openapi: 3.1.1
 info:
@@ -50254,10 +52763,861 @@ components:
 security:
   - ApiKeyAuthHeader: []
   - ApiKeyAuthQuery: []
+`,
+  "domain-typosquatting": `openapi: 3.1.1
+info:
+  title: Domain Typosquatting API - Find Typo and Look-Alike Domains for Brand Protection and Phishing Discovery
+  version: 1.0.0
+  description: Search for registered domains that read like typo variants of a brand keyword, or that match a wildcard pattern, across the full TLD set. Each match returns what is available of its registration date, expiry date, last-seen date, and drop status, paginated at 100 domains per page. Built for brand and trademark protection, phishing discovery, scheduled monitoring, and domain reclaim.
+  contact:
+    name: APIFreaks Support
+    url: https://apifreaks.com/contact
+    email: support@apifreaks.com
+servers:
+  - url: https://api.apifreaks.com/v1.0
+    description: Domain Typosquatting API Server
+paths:
+  /domain/typosquatting:
+    get:
+      tags:
+        - Domain APIs
+      summary: Find registered typo-variant or wildcard-pattern domains for a brand keyword.
+      description: The Domain Typosquatting API searches for registered domains that are typo or look-alike variants of a brand keyword, or that match a wildcard pattern. Results include registration lifecycle data and drop status across 1529+ TLDs, paginated at 100 domains per page.
+      parameters:
+        - name: format
+          in: query
+          required: false
+          schema:
+            type: string
+            enum:
+              - json
+              - xml
+            default: json
+          description: Format of the response.
+        - name: keyword
+          in: query
+          required: false
+          schema:
+            type: string
+            minLength: 3
+            maxLength: 63
+          description: Brand or label to find typo variants for. 3-63 characters, letters, digits, or hyphens, a single label with no dots. Case-insensitive. Use either keyword or pattern, never both.
+        - name: pattern
+          in: query
+          required: false
+          schema:
+            type: string
+            minLength: 3
+            maxLength: 63
+          description: Wildcard search string that combines fuzzy matching with * wildcards. 3-63 characters total, * is the only supported wildcard and each one matches zero or more characters, maximum 3 asterisks per request. Use either keyword or pattern, never both.
+        - name: pageToken
+          in: query
+          required: false
+          schema:
+            type: string
+          description: Token from nextPageToken in the previous response. Required to retrieve page 2 and onward. The original keyword or pattern must be passed alongside the token on every page request. Results page at 100 domains per page.
+      responses:
+        '200':
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DomainTyposquattingResponse'
+              examples:
+                keywordSuccess:
+                  summary: Keyword search (paypal)
+                  value:
+                    status: true
+                    totalRecords: 1284
+                    currentPage: 1
+                    hasNextPage: true
+                    totalPages: 13
+                    nextPageToken: <opaque_token>
+                    domains:
+                      - domainName: p-aypal.com
+                        createDate: '2025-04-17'
+                        expiryDate: '2026-04-17'
+                        lastSeen: '2026-05-29'
+                        isDropped: true
+                      - domainName: p-aypal.de
+                        lastSeen: '2024-07-11'
+                        isDropped: true
+                      - domainName: p0aypal.com
+                        createDate: '2017-12-29'
+                        expiryDate: '2026-12-29'
+                        lastSeen: '2026-08-18'
+                        isDropped: false
+                      - domainName: p7ypal.com
+                        isDropped: true
+                      - domainName: pa-pal.club
+                        createDate: '2019-10-25'
+                        expiryDate: '2020-10-25'
+                        isDropped: false
+                patternSuccess:
+                  summary: Wildcard pattern search (*paypal*)
+                  value:
+                    status: true
+                    totalRecords: 5471
+                    currentPage: 1
+                    hasNextPage: true
+                    totalPages: 55
+                    nextPageToken: <opaque_token>
+                    domains:
+                      - domainName: paypal-support.com
+                        createDate: '2024-11-02'
+                        expiryDate: '2026-11-02'
+                        lastSeen: '2026-08-30'
+                        isDropped: false
+                      - domainName: login-paypal.net
+                        lastSeen: '2025-12-14'
+                        isDropped: true
+                emptyResult:
+                  summary: No matches found
+                  value:
+                    status: true
+                    totalRecords: 0
+                    currentPage: 1
+                    hasNextPage: false
+                    totalPages: 0
+                    domains: []
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
+        '400':
+          description: Bad Request \u2013 Invalid parameters
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+              examples:
+                shortPattern:
+                  summary: Pattern has too few non-wildcard characters
+                  value:
+                    error: Invalid Pattern Exception
+                    message: The pattern must contain at least 5 non-wildcard characters and no more than 3 wildcards.
+                    path: /v1.0/domain/typosquatting
+                    status: 400
+                    timestamp: '2026-09-08T12:00:00.000Z'
+                bothParams:
+                  summary: Both keyword and pattern supplied
+                  value:
+                    error: Invalid Param Exception
+                    message: Use either the "keyword" or the "pattern" parameter, never both.
+                    path: /v1.0/domain/typosquatting
+                    status: 400
+                    timestamp: '2026-09-08T12:00:00.000Z'
+                missingParam:
+                  summary: Neither keyword nor pattern supplied
+                  value:
+                    error: Invalid Param Exception
+                    message: Please provide either a "keyword" or a "pattern" parameter.
+                    path: /v1.0/domain/typosquatting
+                    status: 400
+                    timestamp: '2026-09-08T12:00:00.000Z'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
+      operationId: getDomainTyposquatting
+components:
+  securitySchemes:
+    ApiKeyAuthHeader:
+      type: apiKey
+      in: header
+      name: X-apiKey
+      description: Pass your API key via the X-apiKey request header.
+    ApiKeyAuthQuery:
+      type: apiKey
+      in: query
+      name: apiKey
+      description: Pass your API key via the apiKey query parameter.
+  schemas:
+    DomainTyposquattingResponse:
+      type: object
+      required:
+        - status
+        - totalRecords
+        - currentPage
+        - hasNextPage
+        - totalPages
+        - domains
+      properties:
+        status:
+          type: boolean
+          description: Indicates if the request was successful.
+        totalRecords:
+          type: integer
+          description: Total number of domains found.
+        currentPage:
+          type: integer
+          description: Page number of the current response. Starts at 1.
+        hasNextPage:
+          type: boolean
+          description: true if at least one additional page is available.
+        totalPages:
+          type: integer
+          description: Total number of pages available.
+        nextPageToken:
+          type: string
+          description: Opaque token to pass as pageToken on the next request. Present only when hasNextPage is true.
+        domains:
+          type: array
+          items:
+            $ref: '#/components/schemas/DomainItem'
+          description: List of typo-variant or pattern-matched domains on the current page.
+      description: Paginated response containing typo-variant or pattern-matched domains.
+    DomainItem:
+      type: object
+      required:
+        - domainName
+        - isDropped
+      properties:
+        domainName:
+          type: string
+          description: Domain name.
+        createDate:
+          type: string
+          description: Domain creation date (YYYY-MM-DD). May be absent for older or less-actively-tracked entries.
+        expiryDate:
+          type: string
+          description: Domain expiration date (YYYY-MM-DD). May be absent for older or less-actively-tracked entries.
+        lastSeen:
+          type: string
+          description: Last time the domain was observed (YYYY-MM-DD). One of the two fields reliably meaningful across a full result set.
+        isDropped:
+          type: boolean
+          description: Indicates whether the domain has dropped out of the registry and become available to register again.
+      description: A single typo-variant or pattern-matched domain with registration lifecycle data.
+    ErrorResponse:
+      type: object
+      description: Standard error envelope returned by the API on failed requests.
+      required:
+        - message
+      properties:
+        error:
+          type: string
+          description: Short error category or exception type.
+        message:
+          type: string
+          description: Human-readable error message describing the failure.
+        path:
+          type: string
+          description: API endpoint path that produced the error.
+        status:
+          type: integer
+          description: HTTP status code returned with the error.
+        timestamp:
+          type: string
+          format: date-time
+          description: Timestamp when the error occurred (ISO 8601).
+  headers:
+    X-AF-Credits-Cost:
+      description: Specifies the number of credits consumed by the current request.
+      schema:
+        type: integer
+security:
+  - ApiKeyAuthHeader: []
+  - ApiKeyAuthQuery: []
 `,
   "subdomain-lookup": "openapi: 3.1.1\ninfo:\n  title: Subdomain Finder API - Discover Active, Inactive & Historical Subdomains\n  version: 1.0.0\n  description: Retrieve subdomains related to a given domain name. Returns paginated results with subdomain details including first seen and last seen dates. Supports filtering by date range, status (active/inactive), and pagination with configurable page numbers.\n  contact:\n    name: APIFreaks Support\n    url: https://apifreaks.com/contact\n    email: support@apifreaks.com\nservers:\n  - url: https://api.apifreaks.com/v1.0\n    description: Subdomain Lookup API Server\npaths:\n  /subdomains/lookup:\n    get:\n      tags:\n        - Domain APIs\n      summary: Get subdomains related to the given domain name.\n      description: The Subdomain Lookup API is designed to retrieve subdomains related to the given domain name. It helps you explore subdomains that are available for registration or usage.\n      parameters:\n        - name: format\n          in: query\n          required: false\n          schema:\n            type: string\n            enum:\n              - json\n              - xml\n            default: json\n          description: Format of the response.\n        - name: domain\n          in: query\n          required: true\n          schema:\n            type: string\n          description: Domain name for availability and suggestions.\n        - name: after\n          in: query\n          required: false\n          schema:\n            type: string\n            format: date\n          description: Filter subdomains seen after this date (format YYYY-MM-DD).\n        - name: before\n          in: query\n          required: false\n          schema:\n            type: string\n            format: date\n          description: Filter subdomains seen before this date( format YYYY-MM-DD).\n        - name: status\n          in: query\n          required: false\n          schema:\n            type: string\n            enum:\n              - active\n              - inactive\n            default: active\n          description: Filter subdomains by status (active or inactive).\n        - name: page\n          in: query\n          required: false\n          schema:\n            type: integer\n            default: 1\n          description: Page number for paginated results.\n      responses:\n        '200':\n          description: Success\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/SubDomainResponse'\n              examples:\n                success:\n                  summary: Successful response\n                  value:\n                    domain: google.com\n                    status: true\n                    query_time: '2026-07-27T12:22:26.954268895'\n                    current_page: 1\n                    total_pages: 1543\n                    total_records: 154233\n                    subdomains:\n                      - subdomain: 49qq1sm.sites.google.com\n                        first_seen: '2024-03-03'\n                        last_seen: '2026-06-18'\n                      - subdomain: tvgkp5.feedproxy.ghs.google.com\n                        last_seen: '2026-07-04'\n                      - subdomain: www.reusablesec.sites.google.com\n                        first_seen: '2020-02-18'\n                        last_seen: '2026-06-20'\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n        '400':\n          description: Bad Request \u2013 one or more parameters are invalid\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                missingDomain:\n                  summary: Missing required domain parameter\n                  value:\n                    error: Invalid Param Exception\n                    message: please pass correct parameters\n                    path: /v1.0/subdomains/lookup\n                    status: 400\n                    timestamp: '2026-07-27T12:22:27.587Z'\n                invalidDomain:\n                  summary: domain is not a syntactically valid domain name\n                  value:\n                    timestamp: '2026-07-27T12:22:40.119716922Z'\n                    status: 400\n                    error: Invalid Param Exception\n                    message: 'Please pass domain param correct value[For Technical Support: support@whoisfreaks.com]'\n                    path: /v1.0/subdomains\n                AfterDateError:\n                  summary: after is not earlier than before\n                  value:\n                    timestamp: '2026-07-27T12:22:28.233751455Z'\n                    status: 400\n                    error: Invalid Param Exception\n                    message: after date must be earlier than before date.\n                    path: /v1.0/subdomains\n                AfterDateGreaterThanCurrent:\n                  summary: after is in the future\n                  value:\n                    timestamp: '2026-07-27T12:22:39.061042798Z'\n                    status: 400\n                    error: Invalid Param Exception\n                    message: after date cannot be greater than the current date.\n                    path: /v1.0/subdomains\n                BeforeDateGreaterThanCurrent:\n                  summary: before is in the future\n                  value:\n                    timestamp: '2026-07-27T12:22:39.609545647Z'\n                    status: 400\n                    error: Invalid Param Exception\n                    message: before date cannot be greater than the current date.\n                    path: /v1.0/subdomains\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n        '408':\n          description: Request Timeout \u2013 Unable to fetch WHOIS data\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                error:\n                  summary: Error response\n                  value:\n                    timestamp: '2025-08-14T10:37:21.871Z'\n                    status: 408\n                    error: Request Timeout\n                    message: 'Unable to fetch whois data. Please try again. [For Technical Support email at: support@apifreaks.com]'\n                    path: /v1.0/subdomains/lookup\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n      operationId: lookupSubdomains\ncomponents:\n  securitySchemes:\n    ApiKeyAuthHeader:\n      type: apiKey\n      in: header\n      name: X-apiKey\n      description: Pass your API key via the X-apiKey request header.\n    ApiKeyAuthQuery:\n      type: apiKey\n      in: query\n      name: apiKey\n      description: Pass your API key via the apiKey query parameter.\n  schemas:\n    SubDomainResponse:\n      type: object\n      required:\n        - domain\n        - status\n        - query_time\n        - current_page\n        - total_pages\n        - total_records\n        - subdomains\n      properties:\n        domain:\n          type: string\n          description: The domain name for which subdomains are retrieved.\n        status:\n          type: boolean\n          description: Indicates whether the request was successfully processed or not.\n        query_time:\n          type: string\n          description: Timestamp showing when the API request was executed.\n        current_page:\n          type: integer\n          description: The current page number of the paginated response.\n        total_pages:\n          type: integer\n          description: Total number of pages available for the given query. Each page has 100 subdomain entries.\n        total_records:\n          type: integer\n          description: Total number of subdomains found for the domain.\n        subdomains:\n          type: array\n          description: Returns an array of subdomain objects. Each object contains detailed information about an individual subdomain.\n          items:\n            $ref: '#/components/schemas/SubdomainItem'\n      description: Subdomain lookup response containing paginated subdomain results.\n    SubdomainItem:\n      type: object\n      description: A single subdomain record with discovery dates.\n      required:\n        - subdomain\n        - last_seen\n      properties:\n        subdomain:\n          type: string\n          description: The discovered subdomain associated with the given domain.\n        first_seen:\n          type: string\n          format: date\n          description: The date when the subdomain was first discovered. Can be absent for some records.\n        last_seen:\n          type: string\n          format: date\n          description: The most recent date when the subdomain was observed.\n        inactive_from:\n          type: string\n          format: date\n          description: The date from which the subdomain is considered inactive. Appears only if inactive.\n    ErrorResponse:\n      type: object\n      description: Standard error envelope returned by the API on failed requests.\n      required:\n        - message\n      properties:\n        error:\n          type: string\n          description: Short error category or exception type.\n        message:\n          type: string\n          description: Human-readable error message describing the failure.\n        path:\n          type: string\n          description: API endpoint path that produced the error.\n        status:\n          type: integer\n          description: HTTP status code returned with the error.\n        timestamp:\n          type: string\n          format: date-time\n          description: Timestamp when the error occurred (ISO 8601).\n  headers:\n    X-AF-Credits-Cost:\n      description: Specifies the number of credits consumed by the current request.\n      schema:\n        type: integer\nsecurity:\n  - ApiKeyAuthHeader: []\n  - ApiKeyAuthQuery: []\n",
-  "bulk-email-validation": "openapi: 3.1.1\ninfo:\n  title: Bulk Email Validation API - Validate and Verify Emails in Bulk\n  version: 1.0.0\n  description: Validate up to 10 email addresses in a single POST request. Each email is processed independently. Returns an array of validation results with deliverability assessment per email, plus per-item error objects for failed validations. Maximum 10 email addresses per request.\n  contact:\n    name: APIFreaks Support\n    url: https://apifreaks.com/contact\n    email: support@apifreaks.com\nservers:\n  - url: https://api.apifreaks.com/v1.0\n    description: Bulk Email Validation API Server\npaths:\n  /email-validation/bulk:\n    post:\n      tags:\n        - Email Validation APIs\n      summary: Validate multiple email addresses\n      description: Validates a bulk of email addresses and returns result for each. Maximum `10` email addresses per request.\n      parameters:\n        - name: format\n          in: query\n          required: false\n          schema:\n            type: string\n            enum:\n              - json\n              - xml\n            default: json\n          description: Format of the response\n      requestBody:\n        required: true\n        content:\n          application/json:\n            schema:\n              $ref: '#/components/schemas/BulkEmailRequest'\n      responses:\n        '200':\n          description: Successful response. Each item corresponds to one requested email, in the same order as the request; invalid emails are reflected via validEmail/validSyntax on that item, not as a separate error object \u2014 every item has success=true regardless of validation outcome.\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/BulkEmailValidationResponse'\n              examples:\n                bulkEmailsValidated:\n                  summary: Mix of a valid and a syntactically invalid email\n                  value:\n                    emailResponse:\n                      - success: true\n                        email: abc.def@gmail.com\n                        validEmail: valid\n                        validSyntax: true\n                        domain:\n                          name: gmail.com\n                          disposable: false\n                          spam: false\n                          free: true\n                          validDomain: true\n                          catchAll: false\n                        account:\n                          role: false\n                          fullMailBox: false\n                        dns:\n                          mxRecord:\n                            - gmail-smtp-in.l.google.com.\n                            - alt1.gmail-smtp-in.l.google.com.\n                            - alt2.gmail-smtp-in.l.google.com.\n                            - alt3.gmail-smtp-in.l.google.com.\n                            - alt4.gmail-smtp-in.l.google.com.\n                      - success: true\n                        email: not-an-email\n                        validEmail: INVALID_EMAIL\n                        validSyntax: false\n                        domain:\n                          name: not-an-email\n                          validDomain: false\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n            X-Concurrent-Threads:\n              $ref: '#/components/headers/X-Concurrent-Threads'\n            X-Concurrent-Threads-Active:\n              $ref: '#/components/headers/X-Concurrent-Threads-Active'\n        '400':\n          description: Bad Request \u2013 Invalid request body\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                invalidBody:\n                  summary: emailData field missing or malformed\n                  value:\n                    timestamp: '2026-07-27T12:53:14.628Z'\n                    path: /v1.0/email-validation/bulk\n                    status: 400\n                    error: Invalid request body Exception\n                    message: Please provide data in required format in request body\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n        '404':\n          description: Not Found \u2013 The requested resource could not be found\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                Resource Not Found:\n                  value:\n                    timestamp: '2026-09-02T11:57:55.592Z'\n                    path: /v1.0/email-validation/bulkx\n                    status: 404\n                    error: Resource Not Found\n                    message: The requested resource could not be found. Please verify the URL and try again.\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n        '408':\n          description: Request Timeout\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                Request Timeout:\n                  value:\n                    timestamp: '2026-06-06T13:00:00.000Z'\n                    path: /v1.0/email-validation/bulk\n                    status: 408\n                    error: Request Timeout\n                    message: Timed out while connecting to the remote URL.\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n        '413':\n          description: Payload Too Large \u2013 emailData exceeds the maximum of 10 entries per request\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                Payload Too Large:\n                  value:\n                    timestamp: '2026-09-02T11:57:34.223Z'\n                    path: /v2/email-validation/bulk\n                    status: 413\n                    error: Payload too large Exception\n                    message: Maximum request body size limit exceeded\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n        '429':\n          description: Rate Limit Exceeded\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                Rate Limit Exceeded:\n                  value:\n                    timestamp: '2026-06-06T13:00:00.000Z'\n                    path: /v1.0/email-validation/bulk\n                    status: 429\n                    error: Too Many Requests\n                    message: API rate limit exceeded.\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n      operationId: bulkCheckEmail\ncomponents:\n  securitySchemes:\n    ApiKeyAuthHeader:\n      type: apiKey\n      in: header\n      name: X-apiKey\n      description: Pass your API key via the X-apiKey request header.\n    ApiKeyAuthQuery:\n      type: apiKey\n      in: query\n      name: apiKey\n      description: Pass your API key via the apiKey query parameter.\n  schemas:\n    BulkEmailValidationResponse:\n      type: object\n      description: Wrapper containing the per-email results array.\n      required:\n        - emailResponse\n      properties:\n        emailResponse:\n          type: array\n          description: Array of per-email results, one entry per requested email, in the same order as the request. Invalid emails are reflected via validEmail/validSyntax, not a separate error shape.\n          items:\n            $ref: '#/components/schemas/SingleEmailValidationResponse'\n    SingleEmailValidationResponse:\n      type: object\n      required:\n        - success\n        - email\n        - validEmail\n        - validSyntax\n        - domain\n      properties:\n        success:\n          type: boolean\n          description: 'Indicates the processing status of the validation request. true: completed successfully.'\n        email:\n          type: string\n          format: email\n          description: The email address submitted for validation.\n        name:\n          type: string\n          description: Optional identifier or label provided in the request for record tracking.\n        reason:\n          type: string\n          description: Detailed explanation returned when validEmail is not valid.\n        validEmail:\n          type: string\n          enum:\n            - valid\n            - invalid\n            - INVALID_EMAIL\n            - unknown\n            - risky\n            - app_server_blocked\n          description: 'Comprehensive deliverability assessment. Casing is inconsistent in the live API: syntactically invalid addresses return INVALID_EMAIL, while semantically invalid (undeliverable) addresses return lowercase invalid. risky is a documented possibility not observed during testing. app_server_blocked is returned when the recipient mail server blocked the live verification attempt (reason explains that retrying later may succeed).'\n        validSyntax:\n          type: boolean\n          description: Validates email address format compliance with RFC 5322 standards.\n        domain:\n          $ref: '#/components/schemas/DomainObject'\n        account:\n          $ref: '#/components/schemas/AccountObject'\n        dns:\n          $ref: '#/components/schemas/DnsObject'\n        address:\n          $ref: '#/components/schemas/AddressObject'\n        ip:\n          type: string\n          format: ip\n          description: IP address provided for geolocation and security enrichment.\n      description: Email validation response containing deliverability assessment and metadata.\n    DomainObject:\n      type: object\n      required:\n        - name\n        - validDomain\n      properties:\n        name:\n          type: string\n          description: Extracted domain component from the email address.\n        validDomain:\n          type: boolean\n          description: Domain validation status confirming DNS resolution capability.\n        disposable:\n          type: boolean\n          description: Classification flag identifying domains from temporary email service providers.\n        spam:\n          type: boolean\n          description: Reputation indicator flagging domains on spam databases.\n        free:\n          type: boolean\n          description: Classification indicating free or consumer-grade email service providers.\n        catchAll:\n          type: boolean\n          description: Detection flag for domains configured to accept mail for any recipient address.\n      description: Domain validation details for the email address.\n    AccountObject:\n      type: object\n      required:\n        - role\n      properties:\n        role:\n          type: boolean\n          description: Detection flag identifying role-based email addresses (e.g., admin@, support@).\n        fullMailBox:\n          type: boolean\n          description: Storage capacity status indicator for the recipient mailbox.\n      description: Account-level validation details.\n    DnsObject:\n      type: object\n      required:\n        - mxRecord\n      properties:\n        mxRecord:\n          type: array\n          items:\n            type: string\n          description: Collection of MX (Mail Exchange) hostname records from DNS queries.\n        aRecord:\n          type: array\n          items:\n            type: string\n          description: Collection of A (Address) records for the domain. Not observed in testing \u2014 may be rarely or never populated.\n      description: DNS records for the email domain.\n    AddressObject:\n      type: object\n      properties:\n        validIpAddress:\n          type: boolean\n          description: IP recognized/reachable by the geolocation provider.\n        location:\n          $ref: '#/components/schemas/EmailLocation'\n        security:\n          $ref: '#/components/schemas/EmailSecurity'\n      description: Geolocation and security enrichment data for the IP address.\n      required: []\n    EmailLocation:\n      type: object\n      description: Geolocation data derived from the IP address.\n      properties:\n        city:\n          type: string\n          description: Municipal or city name.\n        district:\n          type: string\n          description: District or neighborhood.\n        zipcode:\n          type: string\n          description: Postal or ZIP code.\n        state_prov:\n          type: string\n          description: State or province.\n        country_name:\n          type: string\n          description: Common country name.\n        country_name_official:\n          type: string\n          description: Official country name.\n        country_code2:\n          type: string\n          description: Two-character ISO country code.\n        country_code3:\n          type: string\n          description: Three-character ISO country code.\n        continent_name:\n          type: string\n          description: Continental region name.\n        continent_code:\n          type: string\n          description: Continental region identifier.\n        accuracy_radius:\n          type: string\n          description: Geolocation precision radius.\n        confidence:\n          type: string\n          description: Confidence score for geolocation accuracy.\n        is_eu:\n          type: boolean\n          description: European Union membership status.\n      required: []\n    EmailSecurity:\n      type: object\n      description: Threat and anonymity profile for the IP address.\n      required:\n        - threat_score\n        - is_tor\n        - is_proxy\n        - proxy_type\n        - proxy_provider\n        - is_anonymous\n        - is_known_attacker\n        - is_spam\n        - is_bot\n        - is_cloud_provider\n        - cloud_provider\n      properties:\n        threat_score:\n          type: integer\n          description: Quantitative risk assessment score. Higher values indicate elevated security risk.\n        is_tor:\n          type: boolean\n          description: Detection flag for IP addresses routed through the Tor anonymity network.\n        is_proxy:\n          type: boolean\n          description: Detection flag identifying IP addresses operating as proxy servers.\n        proxy_type:\n          type: string\n          description: Classification of detected proxy infrastructure type (e.g. VPN, HTTP, SOCKS).\n        proxy_provider:\n          type: string\n          description: Identified service provider operating the proxy infrastructure.\n        is_anonymous:\n          type: boolean\n          description: Anonymization detection flag for IP addresses using identity obfuscation techniques.\n        is_known_attacker:\n          type: boolean\n          description: Threat intelligence flag for IP addresses documented as confirmed malicious sources.\n        is_spam:\n          type: boolean\n          description: Reputation flag for IP addresses associated with spam transmission.\n        is_bot:\n          type: boolean\n          description: Automated traffic detection flag for IP addresses from bot networks.\n        is_cloud_provider:\n          type: boolean\n          description: Infrastructure classification flag for IP addresses from cloud computing providers.\n        cloud_provider:\n          type: string\n          description: Identified cloud infrastructure or hosting service provider name.\n    BulkEmailRequest:\n      type: object\n      description: Request body for bulk email validation.\n      required:\n        - emailData\n      properties:\n        emailData:\n          type: array\n          description: Array of email objects to validate. Maximum 10 per request.\n          maxItems: 10\n          items:\n            $ref: '#/components/schemas/BulkEmailRequestItem'\n    BulkEmailRequestItem:\n      type: object\n      description: A single email entry in a bulk validation request.\n      required:\n        - email\n      properties:\n        email:\n          type: string\n          format: email\n          description: Email address to validate.\n        name:\n          type: string\n          description: Optional name or label.\n        ip:\n          type: string\n          format: ip\n          description: Optional IP address for enrichment.\n    ErrorResponse:\n      type: object\n      description: Standard error envelope returned by the API on failed requests.\n      required:\n        - message\n      properties:\n        error:\n          type: string\n          description: Short error category or exception type.\n        message:\n          type: string\n          description: Human-readable error message describing the failure.\n        path:\n          type: string\n          description: API endpoint path that produced the error.\n        status:\n          type: integer\n          description: HTTP status code returned with the error.\n        timestamp:\n          type: string\n          format: date-time\n          description: Timestamp when the error occurred (ISO 8601).\n  headers:\n    X-AF-Credits-Cost:\n      description: Specifies the number of credits consumed by the current request.\n      schema:\n        type: integer\n    X-Concurrent-Threads:\n      description: Specifies the maximum number of concurrent requests allowed.\n      schema:\n        type: integer\n    X-Concurrent-Threads-Active:\n      description: Indicates the number of active concurrent requests being processed.\n      schema:\n        type: integer\nsecurity:\n  - ApiKeyAuthHeader: []\n  - ApiKeyAuthQuery: []\n",
-  "email-checker": "openapi: 3.1.1\ninfo:\n  title: Email Checker API - Real-Time Validation, Deliverability & Risk Signals\n  version: 1.0.0\n  description: Validate a single email address and receive comprehensive results including syntax validation, domain verification, account detection, DNS records (MX and A records), and optional IP-based geolocation and security enrichment. Returns deliverability assessment with valid/invalid/unknown/risky/app_server_blocked status.\n  contact:\n    name: APIFreaks Support\n    url: https://apifreaks.com/contact\n    email: support@apifreaks.com\nservers:\n  - url: https://api.apifreaks.com/v1.0\n    description: Email Checker API Server\npaths:\n  /email-validation/single:\n    post:\n      tags:\n        - Email Validation APIs\n      summary: Validate a single email\n      description: Validates a single email address and returns result.\n      parameters:\n        - name: format\n          in: query\n          required: false\n          schema:\n            type: string\n            enum:\n              - json\n              - xml\n          description: Format of the response\n      requestBody:\n        required: true\n        content:\n          application/json:\n            schema:\n              $ref: '#/components/schemas/EmailCheckRequest'\n      responses:\n        '200':\n          description: Successful response with Email Validation\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/SingleEmailValidationResponse'\n              examples:\n                validEmail:\n                  summary: Valid, deliverable email\n                  value:\n                    success: true\n                    email: abc.def@gmail.com\n                    validEmail: valid\n                    validSyntax: true\n                    domain:\n                      name: gmail.com\n                      disposable: false\n                      spam: false\n                      free: true\n                      validDomain: true\n                      catchAll: false\n                    account:\n                      role: false\n                      fullMailBox: false\n                    dns:\n                      mxRecord:\n                        - gmail-smtp-in.l.google.com.\n                        - alt1.gmail-smtp-in.l.google.com.\n                        - alt2.gmail-smtp-in.l.google.com.\n                        - alt3.gmail-smtp-in.l.google.com.\n                        - alt4.gmail-smtp-in.l.google.com.\n                invalidSyntax:\n                  summary: Syntactically invalid email \u2014 domain/account/dns are minimal or absent\n                  value:\n                    success: true\n                    email: not-an-email\n                    validEmail: INVALID_EMAIL\n                    validSyntax: false\n                    domain:\n                      name: not-an-email\n                      validDomain: false\n                noMxRecord:\n                  summary: Valid syntax, domain has no MX record\n                  value:\n                    success: true\n                    email: test@nonexistentdomainxyz123abc.com\n                    validEmail: invalid\n                    validSyntax: true\n                    reason: mx record does not exist.\n                    domain:\n                      name: nonexistentdomainxyz123abc.com\n                      disposable: false\n                      spam: false\n                      free: false\n                      validDomain: false\n                      catchAll: false\n                    account:\n                      role: false\n                withIp:\n                  summary: With ip \u2014 adds geolocation/security enrichment under address\n                  value:\n                    success: true\n                    email: abc.def@gmail.com\n                    validEmail: valid\n                    validSyntax: true\n                    domain:\n                      name: gmail.com\n                      disposable: false\n                      spam: false\n                      free: true\n                      validDomain: true\n                      catchAll: false\n                    account:\n                      role: false\n                      fullMailBox: false\n                    dns:\n                      mxRecord:\n                        - gmail-smtp-in.l.google.com.\n                        - alt1.gmail-smtp-in.l.google.com.\n                        - alt2.gmail-smtp-in.l.google.com.\n                        - alt3.gmail-smtp-in.l.google.com.\n                        - alt4.gmail-smtp-in.l.google.com.\n                    ip: 8.8.8.8\n                    address:\n                      validIpAddress: true\n                      location:\n                        city: Mountain View\n                        district: Santa Clara\n                        confidence: low\n                        zipcode: 94043-1351\n                        state_prov: California\n                        country_name: United States\n                        continent_name: North America\n                        continent_code: NA\n                        country_code2: US\n                        country_code3: USA\n                        country_name_official: United States of America\n                        accuracy_radius: '27.42'\n                        is_eu: false\n                      security:\n                        threat_score: 5\n                        is_tor: false\n                        is_proxy: false\n                        proxy_type: ''\n                        proxy_provider: ''\n                        is_anonymous: false\n                        is_known_attacker: false\n                        is_spam: false\n                        is_bot: false\n                        is_cloud_provider: true\n                        cloud_provider: Google LLC\n                appServerBlocked:\n                  summary: Valid syntax, but the recipient mail server blocked the verification attempt\n                  value:\n                    success: true\n                    email: randomuser98765zzz@gmx.com\n                    validEmail: app_server_blocked\n                    validSyntax: true\n                    reason: We are unable to determine the validity of email at the moment. Please try later.\n                    domain:\n                      name: gmx.com\n                      disposable: false\n                      spam: false\n                      free: true\n                      validDomain: true\n                      catchAll: false\n                    account:\n                      role: false\n                    dns:\n                      mxRecord:\n                        - mx00.gmx.net.\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n            X-Concurrent-Threads:\n              $ref: '#/components/headers/X-Concurrent-Threads'\n            X-Concurrent-Threads-Active:\n              $ref: '#/components/headers/X-Concurrent-Threads-Active'\n        '400':\n          description: Bad Request \u2013 Invalid request body\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                missingEmail:\n                  summary: email field missing from request body\n                  value:\n                    timestamp: '2026-09-02T11:56:23.462Z'\n                    path: /v2/email-validation/single\n                    status: 400\n                    error: Missing or Invalid Parameters\n                    message: Please pass valid value for 'email' in body.\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n            X-Concurrent-Threads:\n              $ref: '#/components/headers/X-Concurrent-Threads'\n            X-Concurrent-Threads-Active:\n              $ref: '#/components/headers/X-Concurrent-Threads-Active'\n        '404':\n          description: Not Found \u2013 The requested resource could not be found\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                Resource Not Found:\n                  value:\n                    timestamp: '2026-09-02T11:56:23.937Z'\n                    path: /v1.0/email-validation/singlex\n                    status: 404\n                    error: Resource Not Found\n                    message: The requested resource could not be found. Please verify the URL and try again.\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n            X-Concurrent-Threads:\n              $ref: '#/components/headers/X-Concurrent-Threads'\n            X-Concurrent-Threads-Active:\n              $ref: '#/components/headers/X-Concurrent-Threads-Active'\n        '408':\n          description: Request Timeout\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                Request Timeout:\n                  value:\n                    timestamp: '2026-06-06T13:00:00.000Z'\n                    path: /v1.0/email-validation/single\n                    status: 408\n                    error: Request Timeout\n                    message: Timed out while connecting to the remote URL.\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n            X-Concurrent-Threads:\n              $ref: '#/components/headers/X-Concurrent-Threads'\n            X-Concurrent-Threads-Active:\n              $ref: '#/components/headers/X-Concurrent-Threads-Active'\n        '429':\n          description: Rate Limit Exceeded\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                Rate Limit Exceeded:\n                  value:\n                    timestamp: '2026-06-06T13:00:00.000Z'\n                    path: /v1.0/email-validation/single\n                    status: 429\n                    error: Too Many Requests\n                    message: API rate limit exceeded.\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n            X-Concurrent-Threads:\n              $ref: '#/components/headers/X-Concurrent-Threads'\n            X-Concurrent-Threads-Active:\n              $ref: '#/components/headers/X-Concurrent-Threads-Active'\n      operationId: checkEmail\ncomponents:\n  securitySchemes:\n    ApiKeyAuthHeader:\n      type: apiKey\n      in: header\n      name: X-apiKey\n      description: Pass your API key via the X-apiKey request header.\n    ApiKeyAuthQuery:\n      type: apiKey\n      in: query\n      name: apiKey\n      description: Pass your API key via the apiKey query parameter.\n  schemas:\n    SingleEmailValidationResponse:\n      type: object\n      required:\n        - success\n        - email\n        - validEmail\n        - validSyntax\n        - domain\n      properties:\n        success:\n          type: boolean\n          description: 'Indicates the processing status of the validation request. true: completed successfully.'\n        email:\n          type: string\n          format: email\n          description: The email address submitted for validation.\n        name:\n          type: string\n          description: Optional identifier or label provided in the request for record tracking.\n        reason:\n          type: string\n          description: Detailed explanation returned when validEmail is not valid.\n        validEmail:\n          type: string\n          enum:\n            - valid\n            - invalid\n            - INVALID_EMAIL\n            - unknown\n            - risky\n            - app_server_blocked\n          description: 'Comprehensive deliverability assessment. Casing is inconsistent in the live API: syntactically invalid addresses return INVALID_EMAIL, while semantically invalid (undeliverable) addresses return lowercase invalid. risky is a documented possibility not observed during testing. app_server_blocked is returned when the recipient mail server blocked the live verification attempt (reason explains that retrying later may succeed).'\n        validSyntax:\n          type: boolean\n          description: Validates email address format compliance with RFC 5322 standards.\n        domain:\n          $ref: '#/components/schemas/DomainObject'\n        account:\n          $ref: '#/components/schemas/AccountObject'\n        dns:\n          $ref: '#/components/schemas/DnsObject'\n        address:\n          $ref: '#/components/schemas/AddressObject'\n        ip:\n          type: string\n          format: ip\n          description: IP address provided for geolocation and security enrichment.\n      description: Email validation response containing deliverability assessment and metadata.\n    DomainObject:\n      type: object\n      required:\n        - name\n        - validDomain\n      properties:\n        name:\n          type: string\n          description: Extracted domain component from the email address.\n        validDomain:\n          type: boolean\n          description: Domain validation status confirming DNS resolution capability.\n        disposable:\n          type: boolean\n          description: Classification flag identifying domains from temporary email service providers.\n        spam:\n          type: boolean\n          description: Reputation indicator flagging domains on spam databases.\n        free:\n          type: boolean\n          description: Classification indicating free or consumer-grade email service providers.\n        catchAll:\n          type: boolean\n          description: Detection flag for domains configured to accept mail for any recipient address.\n      description: Domain validation details for the email address.\n    AccountObject:\n      type: object\n      required:\n        - role\n      properties:\n        role:\n          type: boolean\n          description: Detection flag identifying role-based email addresses (e.g., admin@, support@).\n        fullMailBox:\n          type: boolean\n          description: Storage capacity status indicator for the recipient mailbox.\n      description: Account-level validation details.\n    DnsObject:\n      type: object\n      required:\n        - mxRecord\n      properties:\n        mxRecord:\n          type: array\n          items:\n            type: string\n          description: Collection of MX (Mail Exchange) hostname records from DNS queries.\n        aRecord:\n          type: array\n          items:\n            type: string\n          description: Collection of A (Address) records for the domain. Not observed in testing \u2014 may be rarely or never populated.\n      description: DNS records for the email domain.\n    AddressObject:\n      type: object\n      properties:\n        validIpAddress:\n          type: boolean\n          description: IP recognized/reachable by the geolocation provider.\n        location:\n          $ref: '#/components/schemas/EmailLocation'\n        security:\n          $ref: '#/components/schemas/EmailSecurity'\n      description: Geolocation and security enrichment data for the IP address.\n      required: []\n    EmailLocation:\n      type: object\n      description: Geolocation data derived from the IP address.\n      properties:\n        city:\n          type: string\n          description: Municipal or city name.\n        district:\n          type: string\n          description: District or neighborhood.\n        zipcode:\n          type: string\n          description: Postal or ZIP code.\n        state_prov:\n          type: string\n          description: State or province.\n        country_name:\n          type: string\n          description: Common country name.\n        country_name_official:\n          type: string\n          description: Official country name.\n        country_code2:\n          type: string\n          description: Two-character ISO country code.\n        country_code3:\n          type: string\n          description: Three-character ISO country code.\n        continent_name:\n          type: string\n          description: Continental region name.\n        continent_code:\n          type: string\n          description: Continental region identifier.\n        accuracy_radius:\n          type: string\n          description: Geolocation precision radius.\n        confidence:\n          type: string\n          description: Confidence score for geolocation accuracy.\n        is_eu:\n          type: boolean\n          description: European Union membership status.\n      required: []\n    EmailSecurity:\n      type: object\n      description: Threat and anonymity profile for the IP address.\n      required:\n        - threat_score\n        - is_tor\n        - is_proxy\n        - proxy_type\n        - proxy_provider\n        - is_anonymous\n        - is_known_attacker\n        - is_spam\n        - is_bot\n        - is_cloud_provider\n        - cloud_provider\n      properties:\n        threat_score:\n          type: integer\n          description: Quantitative risk assessment score. Higher values indicate elevated security risk.\n        is_tor:\n          type: boolean\n          description: Detection flag for IP addresses routed through the Tor anonymity network.\n        is_proxy:\n          type: boolean\n          description: Detection flag identifying IP addresses operating as proxy servers.\n        proxy_type:\n          type: string\n          description: Classification of detected proxy infrastructure type (e.g. VPN, HTTP, SOCKS).\n        proxy_provider:\n          type: string\n          description: Identified service provider operating the proxy infrastructure.\n        is_anonymous:\n          type: boolean\n          description: Anonymization detection flag for IP addresses using identity obfuscation techniques.\n        is_known_attacker:\n          type: boolean\n          description: Threat intelligence flag for IP addresses documented as confirmed malicious sources.\n        is_spam:\n          type: boolean\n          description: Reputation flag for IP addresses associated with spam transmission.\n        is_bot:\n          type: boolean\n          description: Automated traffic detection flag for IP addresses from bot networks.\n        is_cloud_provider:\n          type: boolean\n          description: Infrastructure classification flag for IP addresses from cloud computing providers.\n        cloud_provider:\n          type: string\n          description: Identified cloud infrastructure or hosting service provider name.\n    EmailCheckRequest:\n      type: object\n      description: Request body for email validation.\n      required:\n        - email\n      properties:\n        email:\n          type: string\n          format: email\n          description: Email address to validate.\n        name:\n          type: string\n          description: Optional name or label for record tracking.\n        ip:\n          type: string\n          format: ip\n          description: Optional IP address for geolocation and security enrichment.\n    ErrorResponse:\n      type: object\n      description: Standard error envelope returned by the API on failed requests.\n      required:\n        - message\n      properties:\n        error:\n          type: string\n          description: Short error category or exception type.\n        message:\n          type: string\n          description: Human-readable error message describing the failure.\n        path:\n          type: string\n          description: API endpoint path that produced the error.\n        status:\n          type: integer\n          description: HTTP status code returned with the error.\n        timestamp:\n          type: string\n          format: date-time\n          description: Timestamp when the error occurred (ISO 8601).\n  headers:\n    X-AF-Credits-Cost:\n      description: Specifies the number of credits consumed by the current request.\n      schema:\n        type: integer\n    X-Concurrent-Threads:\n      description: Specifies the maximum number of concurrent requests allowed.\n      schema:\n        type: integer\n    X-Concurrent-Threads-Active:\n      description: Indicates the number of active concurrent requests being processed.\n      schema:\n        type: integer\nsecurity:\n  - ApiKeyAuthHeader: []\n  - ApiKeyAuthQuery: []\n",
+  "bulk-email-validation": "openapi: 3.1.1\ninfo:\n  title: Bulk Email Validation API - Validate and Verify Emails in Bulk\n  version: 1.0.0\n  description: Validate up to 10 email addresses in a single POST request. Each email is processed independently. Returns an array of validation results with deliverability assessment per email (valid/accept_all/invalid/unknown/risky/app_server_blocked), plus per-item error objects for failed validations. Maximum 10 email addresses per request.\n  contact:\n    name: APIFreaks Support\n    url: https://apifreaks.com/contact\n    email: support@apifreaks.com\nservers:\n  - url: https://api.apifreaks.com/v1.0\n    description: Bulk Email Validation API Server\npaths:\n  /email-validation/bulk:\n    post:\n      tags:\n        - Email Validation APIs\n      summary: Validate multiple email addresses\n      description: Validates a bulk of email addresses and returns result for each. Maximum `10` email addresses per request.\n      parameters:\n        - name: format\n          in: query\n          required: false\n          schema:\n            type: string\n            enum:\n              - json\n              - xml\n            default: json\n          description: Format of the response\n      requestBody:\n        required: true\n        content:\n          application/json:\n            schema:\n              $ref: '#/components/schemas/BulkEmailRequest'\n      responses:\n        '200':\n          description: Successful response. Each item corresponds to one requested email, in the same order as the request; invalid emails are reflected via validEmail/validSyntax on that item, not as a separate error object \u2014 every item has success=true regardless of validation outcome.\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/BulkEmailValidationResponse'\n              examples:\n                bulkEmailsValidated:\n                  summary: Mix of valid, syntactically invalid, accept_all, null-MX invalid, and unknown (no-MX probe) results\n                  value:\n                    emailResponse:\n                      - success: true\n                        email: abc.def@gmail.com\n                        validEmail: valid\n                        validSyntax: true\n                        domain:\n                          name: gmail.com\n                          disposable: false\n                          spam: false\n                          free: true\n                          validDomain: true\n                          catchAll: false\n                        account:\n                          role: false\n                          fullMailBox: false\n                        dns:\n                          mxRecord:\n                            - gmail-smtp-in.l.google.com.\n                            - alt1.gmail-smtp-in.l.google.com.\n                            - alt2.gmail-smtp-in.l.google.com.\n                            - alt3.gmail-smtp-in.l.google.com.\n                            - alt4.gmail-smtp-in.l.google.com.\n                      - success: true\n                        email: not-an-email\n                        validEmail: INVALID_EMAIL\n                        validSyntax: false\n                        domain:\n                          name: not-an-email\n                          validDomain: false\n                      - success: true\n                        email: random12345@yahoo.com\n                        validEmail: accept_all\n                        validSyntax: true\n                        reason: domain accepts all addresses.\n                        domain:\n                          name: yahoo.com\n                          disposable: false\n                          spam: false\n                          free: true\n                          validDomain: true\n                          catchAll: true\n                        account:\n                          role: false\n                          fullMailBox: false\n                        dns:\n                          mxRecord:\n                            - mta5.am0.yahoodns.net.\n                            - mta6.am0.yahoodns.net.\n                            - mta7.am0.yahoodns.net.\n                      - success: true\n                        email: test@example.com\n                        validEmail: invalid\n                        validSyntax: true\n                        reason: domain does not accept mail.\n                        domain:\n                          name: example.com\n                          disposable: true\n                          spam: false\n                          free: false\n                          validDomain: true\n                          catchAll: false\n                        account:\n                          role: false\n                        dns:\n                          mxRecord:\n                            - .\n                      - success: true\n                        email: test@neverssl.com\n                        validEmail: unknown\n                        validSyntax: true\n                        reason: We are unable to determine if email is valid or invalid.\n                        domain:\n                          name: neverssl.com\n                          disposable: false\n                          spam: false\n                          free: false\n                          validDomain: true\n                          catchAll: false\n                        account:\n                          role: false\n                        dns:\n                          aRecord:\n                            - 34.223.124.45\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n            X-Concurrent-Threads:\n              $ref: '#/components/headers/X-Concurrent-Threads'\n            X-Concurrent-Threads-Active:\n              $ref: '#/components/headers/X-Concurrent-Threads-Active'\n        '400':\n          description: Bad Request \u2013 Invalid request body\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                invalidBody:\n                  summary: emailData field missing or malformed\n                  value:\n                    timestamp: '2026-07-27T12:53:14.628Z'\n                    path: /v1.0/email-validation/bulk\n                    status: 400\n                    error: Invalid request body Exception\n                    message: Please provide data in required format in request body\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n        '404':\n          description: Not Found \u2013 The requested resource could not be found\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                Resource Not Found:\n                  value:\n                    timestamp: '2026-09-02T11:57:55.592Z'\n                    path: /v1.0/email-validation/bulkx\n                    status: 404\n                    error: Resource Not Found\n                    message: The requested resource could not be found. Please verify the URL and try again.\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n        '408':\n          description: Request Timeout\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                Request Timeout:\n                  value:\n                    timestamp: '2026-06-06T13:00:00.000Z'\n                    path: /v1.0/email-validation/bulk\n                    status: 408\n                    error: Request Timeout\n                    message: Timed out while connecting to the remote URL.\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n        '413':\n          description: Payload Too Large \u2013 emailData exceeds the maximum of 10 entries per request\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                Payload Too Large:\n                  value:\n                    timestamp: '2026-09-02T11:57:34.223Z'\n                    path: /v2/email-validation/bulk\n                    status: 413\n                    error: Payload too large Exception\n                    message: Maximum request body size limit exceeded\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n        '429':\n          description: Rate Limit Exceeded\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                Rate Limit Exceeded:\n                  value:\n                    timestamp: '2026-06-06T13:00:00.000Z'\n                    path: /v1.0/email-validation/bulk\n                    status: 429\n                    error: Too Many Requests\n                    message: API rate limit exceeded.\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n      operationId: bulkCheckEmail\ncomponents:\n  securitySchemes:\n    ApiKeyAuthHeader:\n      type: apiKey\n      in: header\n      name: X-apiKey\n      description: Pass your API key via the X-apiKey request header.\n    ApiKeyAuthQuery:\n      type: apiKey\n      in: query\n      name: apiKey\n      description: Pass your API key via the apiKey query parameter.\n  schemas:\n    BulkEmailValidationResponse:\n      type: object\n      description: Wrapper containing the per-email results array.\n      required:\n        - emailResponse\n      properties:\n        emailResponse:\n          type: array\n          description: Array of per-email results, one entry per requested email, in the same order as the request. Invalid emails are reflected via validEmail/validSyntax, not a separate error shape.\n          items:\n            $ref: '#/components/schemas/SingleEmailValidationResponse'\n    SingleEmailValidationResponse:\n      type: object\n      required:\n        - success\n        - email\n        - validEmail\n        - validSyntax\n        - domain\n      properties:\n        success:\n          type: boolean\n          description: 'Indicates the processing status of the validation request. true: completed successfully.'\n        email:\n          type: string\n          format: email\n          description: The email address submitted for validation.\n        name:\n          type: string\n          description: Optional identifier or label provided in the request for record tracking.\n        reason:\n          type: string\n          description: Detailed explanation returned when validEmail is not valid. Omitted entirely when validEmail is valid.\n        validEmail:\n          type: string\n          enum:\n            - valid\n            - accept_all\n            - invalid\n            - INVALID_EMAIL\n            - unknown\n            - risky\n            - app_server_blocked\n          description: 'Comprehensive deliverability assessment. valid: recipient confirmed deliverable, reason omitted. accept_all: the domain is catch-all and accepted the recipient, so this specific mailbox is unconfirmed \u2014 see domain.catchAll, reason ''domain accepts all addresses.''. invalid: rejected mailbox, syntax failure, or the domain accepts no mail at all (a null MX). unknown: no conclusive answer, most common for domains with no MX record that only get a probe against their address record. risky: mailbox exists but over quota, or the server deferred with a greylist response. app_server_blocked: our verifier IP was blocked by the receiving server. Casing is inconsistent in the live API: syntactically invalid addresses can return the raw enum name INVALID_EMAIL instead of lowercase invalid \u2014 this is a known API bug, handle it defensively as equivalent to invalid.'\n        validSyntax:\n          type: boolean\n          description: Validates email address format compliance with RFC 5322 standards.\n        domain:\n          $ref: '#/components/schemas/DomainObject'\n        account:\n          $ref: '#/components/schemas/AccountObject'\n        dns:\n          $ref: '#/components/schemas/DnsObject'\n        address:\n          $ref: '#/components/schemas/AddressObject'\n        ip:\n          type: string\n          format: ip\n          description: IP address provided for geolocation and security enrichment.\n      description: Email validation response containing deliverability assessment and metadata.\n    DomainObject:\n      type: object\n      required:\n        - name\n        - validDomain\n      properties:\n        name:\n          type: string\n          description: Extracted domain component from the email address.\n        validDomain:\n          type: boolean\n          description: Domain validation status confirming DNS resolution capability.\n        disposable:\n          type: boolean\n          description: Classification flag identifying domains from temporary email service providers.\n        spam:\n          type: boolean\n          description: Reputation indicator flagging domains on spam databases.\n        free:\n          type: boolean\n          description: Classification indicating free or consumer-grade email service providers.\n        catchAll:\n          type: boolean\n          description: Detection flag for domains configured to accept mail for any recipient address. true always corresponds to a top-level validEmail of accept_all.\n      description: Domain validation details for the email address.\n    AccountObject:\n      type: object\n      required:\n        - role\n      properties:\n        role:\n          type: boolean\n          description: Detection flag identifying role-based email addresses (e.g., admin@, support@).\n        fullMailBox:\n          type: boolean\n          description: Storage capacity status indicator for the recipient mailbox.\n      description: Account-level validation details.\n    DnsObject:\n      type: object\n      required: []\n      properties:\n        mxRecord:\n          type: array\n          items:\n            type: string\n          description: Every MX hostname at the domain's lowest preference (not just one). [\".\"]  means the domain publishes a null MX and accepts no mail at all. Absent entirely when the domain has no MX record of any kind \u2014 check aRecord in that case.\n        aRecord:\n          type: array\n          items:\n            type: string\n          description: Collection of A (Address) records for the domain. Present when the domain has no MX record but does resolve to a web server or other host.\n      description: DNS records for the email domain. Absent entirely when the domain publishes neither an MX nor an A record.\n    AddressObject:\n      type: object\n      properties:\n        validIpAddress:\n          type: boolean\n          description: IP recognized/reachable by the geolocation provider.\n        location:\n          $ref: '#/components/schemas/EmailLocation'\n        security:\n          $ref: '#/components/schemas/EmailSecurity'\n      description: Geolocation and security enrichment data for the IP address.\n      required: []\n    EmailLocation:\n      type: object\n      description: Geolocation data derived from the IP address.\n      properties:\n        city:\n          type: string\n          description: Municipal or city name.\n        district:\n          type: string\n          description: District or neighborhood.\n        zipcode:\n          type: string\n          description: Postal or ZIP code.\n        state_prov:\n          type: string\n          description: State or province.\n        country_name:\n          type: string\n          description: Common country name.\n        country_name_official:\n          type: string\n          description: Official country name.\n        country_code2:\n          type: string\n          description: Two-character ISO country code.\n        country_code3:\n          type: string\n          description: Three-character ISO country code.\n        continent_name:\n          type: string\n          description: Continental region name.\n        continent_code:\n          type: string\n          description: Continental region identifier.\n        accuracy_radius:\n          type: string\n          description: Geolocation precision radius.\n        confidence:\n          type: string\n          description: Confidence score for geolocation accuracy.\n        is_eu:\n          type: boolean\n          description: European Union membership status.\n      required: []\n    EmailSecurity:\n      type: object\n      description: Threat and anonymity profile for the IP address.\n      required:\n        - threat_score\n        - is_tor\n        - is_proxy\n        - proxy_type\n        - proxy_provider\n        - is_anonymous\n        - is_known_attacker\n        - is_spam\n        - is_bot\n        - is_cloud_provider\n        - cloud_provider\n      properties:\n        threat_score:\n          type: integer\n          description: Quantitative risk assessment score. Higher values indicate elevated security risk.\n        is_tor:\n          type: boolean\n          description: Detection flag for IP addresses routed through the Tor anonymity network.\n        is_proxy:\n          type: boolean\n          description: Detection flag identifying IP addresses operating as proxy servers.\n        proxy_type:\n          type: string\n          description: Classification of detected proxy infrastructure type (e.g. VPN, HTTP, SOCKS).\n        proxy_provider:\n          type: string\n          description: Identified service provider operating the proxy infrastructure.\n        is_anonymous:\n          type: boolean\n          description: Anonymization detection flag for IP addresses using identity obfuscation techniques.\n        is_known_attacker:\n          type: boolean\n          description: Threat intelligence flag for IP addresses documented as confirmed malicious sources.\n        is_spam:\n          type: boolean\n          description: Reputation flag for IP addresses associated with spam transmission.\n        is_bot:\n          type: boolean\n          description: Automated traffic detection flag for IP addresses from bot networks.\n        is_cloud_provider:\n          type: boolean\n          description: Infrastructure classification flag for IP addresses from cloud computing providers.\n        cloud_provider:\n          type: string\n          description: Identified cloud infrastructure or hosting service provider name.\n    BulkEmailRequest:\n      type: object\n      description: Request body for bulk email validation.\n      required:\n        - emailData\n      properties:\n        emailData:\n          type: array\n          description: Array of email objects to validate. Maximum 10 per request.\n          maxItems: 10\n          items:\n            $ref: '#/components/schemas/BulkEmailRequestItem'\n    BulkEmailRequestItem:\n      type: object\n      description: A single email entry in a bulk validation request.\n      required:\n        - email\n      properties:\n        email:\n          type: string\n          format: email\n          description: Email address to validate.\n        name:\n          type: string\n          description: Optional name or label.\n        ip:\n          type: string\n          format: ip\n          description: Optional IP address for enrichment.\n    ErrorResponse:\n      type: object\n      description: Standard error envelope returned by the API on failed requests.\n      required:\n        - message\n      properties:\n        error:\n          type: string\n          description: Short error category or exception type.\n        message:\n          type: string\n          description: Human-readable error message describing the failure.\n        path:\n          type: string\n          description: API endpoint path that produced the error.\n        status:\n          type: integer\n          description: HTTP status code returned with the error.\n        timestamp:\n          type: string\n          format: date-time\n          description: Timestamp when the error occurred (ISO 8601).\n  headers:\n    X-AF-Credits-Cost:\n      description: Specifies the number of credits consumed by the current request.\n      schema:\n        type: integer\n    X-Concurrent-Threads:\n      description: Specifies the maximum number of concurrent requests allowed.\n      schema:\n        type: integer\n    X-Concurrent-Threads-Active:\n      description: Indicates the number of active concurrent requests being processed.\n      schema:\n        type: integer\nsecurity:\n  - ApiKeyAuthHeader: []\n  - ApiKeyAuthQuery: []\n",
+  "email-checker": `openapi: 3.1.1
+info:
+  title: Email Checker API - Real-Time Validation, Deliverability & Risk Signals
+  version: 1.0.0
+  description: Validate a single email address and receive comprehensive results including syntax validation, domain verification, account detection, DNS records (MX and A records), and optional IP-based geolocation and security enrichment. Returns deliverability assessment with valid/accept_all/invalid/unknown/risky/app_server_blocked status.
+  contact:
+    name: APIFreaks Support
+    url: https://apifreaks.com/contact
+    email: support@apifreaks.com
+servers:
+  - url: https://api.apifreaks.com/v1.0
+    description: Email Checker API Server
+paths:
+  /email-validation/single:
+    post:
+      tags:
+        - Email Validation APIs
+      summary: Validate a single email
+      description: Validates a single email address and returns result.
+      parameters:
+        - name: format
+          in: query
+          required: false
+          schema:
+            type: string
+            enum:
+              - json
+              - xml
+          description: Format of the response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/EmailCheckRequest'
+      responses:
+        '200':
+          description: Successful response with Email Validation
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SingleEmailValidationResponse'
+              examples:
+                validEmail:
+                  summary: Valid, deliverable email
+                  value:
+                    success: true
+                    email: abc.def@gmail.com
+                    validEmail: valid
+                    validSyntax: true
+                    domain:
+                      name: gmail.com
+                      disposable: false
+                      spam: false
+                      free: true
+                      validDomain: true
+                      catchAll: false
+                    account:
+                      role: false
+                      fullMailBox: false
+                    dns:
+                      mxRecord:
+                        - gmail-smtp-in.l.google.com.
+                        - alt1.gmail-smtp-in.l.google.com.
+                        - alt2.gmail-smtp-in.l.google.com.
+                        - alt3.gmail-smtp-in.l.google.com.
+                        - alt4.gmail-smtp-in.l.google.com.
+                invalidSyntax:
+                  summary: Syntactically invalid email \u2014 domain/account/dns are minimal or absent
+                  value:
+                    success: true
+                    email: not-an-email
+                    validEmail: INVALID_EMAIL
+                    validSyntax: false
+                    domain:
+                      name: not-an-email
+                      validDomain: false
+                nonexistentDomain:
+                  summary: Valid syntax, domain does not exist (NXDOMAIN)
+                  value:
+                    success: true
+                    email: test@nonexistentdomainxyz123abc.com
+                    validEmail: invalid
+                    validSyntax: true
+                    reason: mx record does not exist.
+                    domain:
+                      name: nonexistentdomainxyz123abc.com
+                      disposable: false
+                      spam: false
+                      free: false
+                      validDomain: false
+                      catchAll: false
+                    account:
+                      role: false
+                acceptAll:
+                  summary: Catch-all domain accepted the recipient \u2014 mailbox unconfirmed
+                  value:
+                    success: true
+                    email: random12345@yahoo.com
+                    validEmail: accept_all
+                    validSyntax: true
+                    reason: domain accepts all addresses.
+                    domain:
+                      name: yahoo.com
+                      disposable: false
+                      spam: false
+                      free: true
+                      validDomain: true
+                      catchAll: true
+                    account:
+                      role: false
+                      fullMailBox: false
+                    dns:
+                      mxRecord:
+                        - mta5.am0.yahoodns.net.
+                        - mta6.am0.yahoodns.net.
+                        - mta7.am0.yahoodns.net.
+                nullMxDomain:
+                  summary: Domain publishes a null MX (single ".") \u2014 accepts no mail at all
+                  value:
+                    success: true
+                    email: test@example.com
+                    validEmail: invalid
+                    validSyntax: true
+                    reason: domain does not accept mail.
+                    domain:
+                      name: example.com
+                      disposable: true
+                      spam: false
+                      free: false
+                      validDomain: true
+                      catchAll: false
+                    account:
+                      role: false
+                    dns:
+                      mxRecord:
+                        - .
+                noMxAddressOnly:
+                  summary: Domain has no MX record but a working A record \u2014 gets a real SMTP probe
+                  value:
+                    success: true
+                    email: test@neverssl.com
+                    validEmail: unknown
+                    validSyntax: true
+                    reason: We are unable to determine if email is valid or invalid.
+                    domain:
+                      name: neverssl.com
+                      disposable: false
+                      spam: false
+                      free: false
+                      validDomain: true
+                      catchAll: false
+                    account:
+                      role: false
+                    dns:
+                      aRecord:
+                        - 34.223.124.45
+                withIp:
+                  summary: With ip \u2014 adds geolocation/security enrichment under address
+                  value:
+                    success: true
+                    email: abc.def@gmail.com
+                    validEmail: valid
+                    validSyntax: true
+                    domain:
+                      name: gmail.com
+                      disposable: false
+                      spam: false
+                      free: true
+                      validDomain: true
+                      catchAll: false
+                    account:
+                      role: false
+                      fullMailBox: false
+                    dns:
+                      mxRecord:
+                        - gmail-smtp-in.l.google.com.
+                        - alt1.gmail-smtp-in.l.google.com.
+                        - alt2.gmail-smtp-in.l.google.com.
+                        - alt3.gmail-smtp-in.l.google.com.
+                        - alt4.gmail-smtp-in.l.google.com.
+                    ip: 8.8.8.8
+                    address:
+                      validIpAddress: true
+                      location:
+                        city: Mountain View
+                        district: Santa Clara
+                        confidence: low
+                        zipcode: 94043-1351
+                        state_prov: California
+                        country_name: United States
+                        continent_name: North America
+                        continent_code: NA
+                        country_code2: US
+                        country_code3: USA
+                        country_name_official: United States of America
+                        accuracy_radius: '27.42'
+                        is_eu: false
+                      security:
+                        threat_score: 5
+                        is_tor: false
+                        is_proxy: false
+                        proxy_type: ''
+                        proxy_provider: ''
+                        is_anonymous: false
+                        is_known_attacker: false
+                        is_spam: false
+                        is_bot: false
+                        is_cloud_provider: true
+                        cloud_provider: Google LLC
+                appServerBlocked:
+                  summary: Valid syntax, but the recipient mail server blocked the verification attempt
+                  value:
+                    success: true
+                    email: randomuser98765zzz@gmx.com
+                    validEmail: app_server_blocked
+                    validSyntax: true
+                    reason: We are unable to determine the validity of email at the moment. Please try later.
+                    domain:
+                      name: gmx.com
+                      disposable: false
+                      spam: false
+                      free: true
+                      validDomain: true
+                      catchAll: false
+                    account:
+                      role: false
+                    dns:
+                      mxRecord:
+                        - mx00.gmx.net.
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
+            X-Concurrent-Threads:
+              $ref: '#/components/headers/X-Concurrent-Threads'
+            X-Concurrent-Threads-Active:
+              $ref: '#/components/headers/X-Concurrent-Threads-Active'
+        '400':
+          description: Bad Request \u2013 Invalid request body
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+              examples:
+                missingEmail:
+                  summary: email field missing from request body
+                  value:
+                    timestamp: '2026-09-02T11:56:23.462Z'
+                    path: /v2/email-validation/single
+                    status: 400
+                    error: Missing or Invalid Parameters
+                    message: Please pass valid value for 'email' in body.
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
+            X-Concurrent-Threads:
+              $ref: '#/components/headers/X-Concurrent-Threads'
+            X-Concurrent-Threads-Active:
+              $ref: '#/components/headers/X-Concurrent-Threads-Active'
+        '404':
+          description: Not Found \u2013 The requested resource could not be found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+              examples:
+                Resource Not Found:
+                  value:
+                    timestamp: '2026-09-02T11:56:23.937Z'
+                    path: /v1.0/email-validation/singlex
+                    status: 404
+                    error: Resource Not Found
+                    message: The requested resource could not be found. Please verify the URL and try again.
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
+            X-Concurrent-Threads:
+              $ref: '#/components/headers/X-Concurrent-Threads'
+            X-Concurrent-Threads-Active:
+              $ref: '#/components/headers/X-Concurrent-Threads-Active'
+        '408':
+          description: Request Timeout
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+              examples:
+                Request Timeout:
+                  value:
+                    timestamp: '2026-06-06T13:00:00.000Z'
+                    path: /v1.0/email-validation/single
+                    status: 408
+                    error: Request Timeout
+                    message: Timed out while connecting to the remote URL.
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
+            X-Concurrent-Threads:
+              $ref: '#/components/headers/X-Concurrent-Threads'
+            X-Concurrent-Threads-Active:
+              $ref: '#/components/headers/X-Concurrent-Threads-Active'
+        '429':
+          description: Rate Limit Exceeded
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+              examples:
+                Rate Limit Exceeded:
+                  value:
+                    timestamp: '2026-06-06T13:00:00.000Z'
+                    path: /v1.0/email-validation/single
+                    status: 429
+                    error: Too Many Requests
+                    message: API rate limit exceeded.
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
+            X-Concurrent-Threads:
+              $ref: '#/components/headers/X-Concurrent-Threads'
+            X-Concurrent-Threads-Active:
+              $ref: '#/components/headers/X-Concurrent-Threads-Active'
+      operationId: checkEmail
+components:
+  securitySchemes:
+    ApiKeyAuthHeader:
+      type: apiKey
+      in: header
+      name: X-apiKey
+      description: Pass your API key via the X-apiKey request header.
+    ApiKeyAuthQuery:
+      type: apiKey
+      in: query
+      name: apiKey
+      description: Pass your API key via the apiKey query parameter.
+  schemas:
+    SingleEmailValidationResponse:
+      type: object
+      required:
+        - success
+        - email
+        - validEmail
+        - validSyntax
+        - domain
+      properties:
+        success:
+          type: boolean
+          description: 'Indicates the processing status of the validation request. true: completed successfully.'
+        email:
+          type: string
+          format: email
+          description: The email address submitted for validation.
+        name:
+          type: string
+          description: Optional identifier or label provided in the request for record tracking.
+        reason:
+          type: string
+          description: Detailed explanation returned when validEmail is not valid. Omitted entirely when validEmail is valid.
+        validEmail:
+          type: string
+          enum:
+            - valid
+            - accept_all
+            - invalid
+            - INVALID_EMAIL
+            - unknown
+            - risky
+            - app_server_blocked
+          description: 'Comprehensive deliverability assessment. valid: recipient confirmed deliverable, reason omitted. accept_all: the domain is catch-all and accepted the recipient, so this specific mailbox is unconfirmed \u2014 see domain.catchAll, reason ''domain accepts all addresses.''. invalid: rejected mailbox, syntax failure, or the domain accepts no mail at all (a null MX). unknown: no conclusive answer, most common for domains with no MX record that only get a probe against their address record. risky: mailbox exists but over quota, or the server deferred with a greylist response. app_server_blocked: our verifier IP was blocked by the receiving server. Casing is inconsistent in the live API: syntactically invalid addresses can return the raw enum name INVALID_EMAIL instead of lowercase invalid \u2014 this is a known API bug, handle it defensively as equivalent to invalid.'
+        validSyntax:
+          type: boolean
+          description: Validates email address format compliance with RFC 5322 standards.
+        domain:
+          $ref: '#/components/schemas/DomainObject'
+        account:
+          $ref: '#/components/schemas/AccountObject'
+        dns:
+          $ref: '#/components/schemas/DnsObject'
+        address:
+          $ref: '#/components/schemas/AddressObject'
+        ip:
+          type: string
+          format: ip
+          description: IP address provided for geolocation and security enrichment.
+      description: Email validation response containing deliverability assessment and metadata.
+    DomainObject:
+      type: object
+      required:
+        - name
+        - validDomain
+      properties:
+        name:
+          type: string
+          description: Extracted domain component from the email address.
+        validDomain:
+          type: boolean
+          description: Domain validation status confirming DNS resolution capability.
+        disposable:
+          type: boolean
+          description: Classification flag identifying domains from temporary email service providers.
+        spam:
+          type: boolean
+          description: Reputation indicator flagging domains on spam databases.
+        free:
+          type: boolean
+          description: Classification indicating free or consumer-grade email service providers.
+        catchAll:
+          type: boolean
+          description: Detection flag for domains configured to accept mail for any recipient address. true always corresponds to a top-level validEmail of accept_all.
+      description: Domain validation details for the email address.
+    AccountObject:
+      type: object
+      required:
+        - role
+      properties:
+        role:
+          type: boolean
+          description: Detection flag identifying role-based email addresses (e.g., admin@, support@).
+        fullMailBox:
+          type: boolean
+          description: Storage capacity status indicator for the recipient mailbox.
+      description: Account-level validation details.
+    DnsObject:
+      type: object
+      required: []
+      properties:
+        mxRecord:
+          type: array
+          items:
+            type: string
+          description: Every MX hostname at the domain's lowest preference (not just one). ["."]  means the domain publishes a null MX and accepts no mail at all. Absent entirely when the domain has no MX record of any kind \u2014 check aRecord in that case.
+        aRecord:
+          type: array
+          items:
+            type: string
+          description: Collection of A (Address) records for the domain. Present when the domain has no MX record but does resolve to a web server or other host.
+      description: DNS records for the email domain. Absent entirely when the domain publishes neither an MX nor an A record.
+    AddressObject:
+      type: object
+      properties:
+        validIpAddress:
+          type: boolean
+          description: IP recognized/reachable by the geolocation provider.
+        location:
+          $ref: '#/components/schemas/EmailLocation'
+        security:
+          $ref: '#/components/schemas/EmailSecurity'
+      description: Geolocation and security enrichment data for the IP address.
+      required: []
+    EmailLocation:
+      type: object
+      description: Geolocation data derived from the IP address.
+      properties:
+        city:
+          type: string
+          description: Municipal or city name.
+        district:
+          type: string
+          description: District or neighborhood.
+        zipcode:
+          type: string
+          description: Postal or ZIP code.
+        state_prov:
+          type: string
+          description: State or province.
+        country_name:
+          type: string
+          description: Common country name.
+        country_name_official:
+          type: string
+          description: Official country name.
+        country_code2:
+          type: string
+          description: Two-character ISO country code.
+        country_code3:
+          type: string
+          description: Three-character ISO country code.
+        continent_name:
+          type: string
+          description: Continental region name.
+        continent_code:
+          type: string
+          description: Continental region identifier.
+        accuracy_radius:
+          type: string
+          description: Geolocation precision radius.
+        confidence:
+          type: string
+          description: Confidence score for geolocation accuracy.
+        is_eu:
+          type: boolean
+          description: European Union membership status.
+      required: []
+    EmailSecurity:
+      type: object
+      description: Threat and anonymity profile for the IP address.
+      required:
+        - threat_score
+        - is_tor
+        - is_proxy
+        - proxy_type
+        - proxy_provider
+        - is_anonymous
+        - is_known_attacker
+        - is_spam
+        - is_bot
+        - is_cloud_provider
+        - cloud_provider
+      properties:
+        threat_score:
+          type: integer
+          description: Quantitative risk assessment score. Higher values indicate elevated security risk.
+        is_tor:
+          type: boolean
+          description: Detection flag for IP addresses routed through the Tor anonymity network.
+        is_proxy:
+          type: boolean
+          description: Detection flag identifying IP addresses operating as proxy servers.
+        proxy_type:
+          type: string
+          description: Classification of detected proxy infrastructure type (e.g. VPN, HTTP, SOCKS).
+        proxy_provider:
+          type: string
+          description: Identified service provider operating the proxy infrastructure.
+        is_anonymous:
+          type: boolean
+          description: Anonymization detection flag for IP addresses using identity obfuscation techniques.
+        is_known_attacker:
+          type: boolean
+          description: Threat intelligence flag for IP addresses documented as confirmed malicious sources.
+        is_spam:
+          type: boolean
+          description: Reputation flag for IP addresses associated with spam transmission.
+        is_bot:
+          type: boolean
+          description: Automated traffic detection flag for IP addresses from bot networks.
+        is_cloud_provider:
+          type: boolean
+          description: Infrastructure classification flag for IP addresses from cloud computing providers.
+        cloud_provider:
+          type: string
+          description: Identified cloud infrastructure or hosting service provider name.
+    EmailCheckRequest:
+      type: object
+      description: Request body for email validation.
+      required:
+        - email
+      properties:
+        email:
+          type: string
+          format: email
+          description: Email address to validate.
+        name:
+          type: string
+          description: Optional name or label for record tracking.
+        ip:
+          type: string
+          format: ip
+          description: Optional IP address for geolocation and security enrichment.
+    ErrorResponse:
+      type: object
+      description: Standard error envelope returned by the API on failed requests.
+      required:
+        - message
+      properties:
+        error:
+          type: string
+          description: Short error category or exception type.
+        message:
+          type: string
+          description: Human-readable error message describing the failure.
+        path:
+          type: string
+          description: API endpoint path that produced the error.
+        status:
+          type: integer
+          description: HTTP status code returned with the error.
+        timestamp:
+          type: string
+          format: date-time
+          description: Timestamp when the error occurred (ISO 8601).
+  headers:
+    X-AF-Credits-Cost:
+      description: Specifies the number of credits consumed by the current request.
+      schema:
+        type: integer
+    X-Concurrent-Threads:
+      description: Specifies the maximum number of concurrent requests allowed.
+      schema:
+        type: integer
+    X-Concurrent-Threads-Active:
+      description: Indicates the number of active concurrent requests being processed.
+      schema:
+        type: integer
+security:
+  - ApiKeyAuthHeader: []
+  - ApiKeyAuthQuery: []
+`,
   "bulk-vat-rates-country": "openapi: 3.1.1\ninfo:\n  title: Bulk VAT Rates by Country API Reference\n  version: 1.0.0\n  description: Get VAT rates for up to 100 countries or country/state combinations in a single API call. Returns a JSON array of VAT rate results, one entry per country that resolves successfully \u2014 entries with an invalid country/state are silently omitted rather than returned as per-item errors, so the array can be shorter than the requested list. Returns a 400 for a missing/malformed request body and a 413 if the payload exceeds the size limit.\n  contact:\n    name: APIFreaks Support\n    url: https://apifreaks.com/contact\n    email: support@apifreaks.com\nservers:\n  - url: https://api.apifreaks.com/v1.0\n    description: Bulk VAT Rates by Country API Server\npaths:\n  /vat/rates/country:\n    post:\n      tags:\n        - Financial APIs\n      summary: Bulk VAT lookup by country\n      description: Retrieves VAT details for multiple countries or country-state combinations in a single request. Maximum of `100` entries per request are allowed.\n      operationId: bulkVatRatesByCountry\n      parameters:\n        - name: format\n          in: query\n          required: false\n          schema:\n            type: string\n            enum:\n              - json\n              - xml\n            default: json\n          description: 'Specify the desired response format. Options: ''json'' (default) or ''xml''.'\n      requestBody:\n        required: true\n        content:\n          application/json:\n            schema:\n              $ref: '#/components/schemas/BulkVatRequest'\n            examples:\n              typicalRequest:\n                summary: Typical bulk VAT lookup request\n                value:\n                  countries:\n                    - country: DE\n                    - country: United_States\n                      state: New_York\n      responses:\n        '200':\n          description: Successful response \u2014 a JSON array of VAT results, one entry per country that resolved successfully, in request order. Countries that fail to resolve are omitted rather than represented as error entries.\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/VatCountryBulkResponse'\n              examples:\n                typicalSuccess:\n                  summary: All requested countries resolved\n                  value:\n                    - country: DE\n                      type: vat\n                      currency: EUR\n                      standard_rate: 0.19\n                      reduced_rate:\n                        - 0.07\n                        - 0\n                      categories:\n                        books: 0.07\n                        newspapers: 0.07\n                        periodicals: 0.07\n                        broadcasting: 0\n                    - country: United_States\n                      state: New_York\n                      type: vat\n                      currency: ''\n                      standard_rate: 0.04\n                partialMatch:\n                  summary: One of two requested countries resolved \u2014 the unresolved one is simply absent\n                  value:\n                    - country: DE\n                      type: vat\n                      currency: EUR\n                      standard_rate: 0.19\n                      reduced_rate:\n                        - 0.07\n                        - 0\n                      categories:\n                        books: 0.07\n                        newspapers: 0.07\n                        periodicals: 0.07\n                        broadcasting: 0\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n        '400':\n          description: Bad Request \u2014 Missing or malformed request body\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                InvalidBody:\n                  summary: countries field missing or malformed\n                  value:\n                    error: Invalid request body Exception\n                    message: Please provide data in required format in request body\n                    path: /v1.0/vat/rates/country\n                    status: 400\n                    timestamp: '2026-07-27T11:46:29.315Z'\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\n        '413':\n          description: Payload Too Large \u2014 Request body exceeds the size limit\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/ErrorResponse'\n              examples:\n                PayloadTooLarge:\n                  summary: Too many entries / body too large\n                  value:\n                    error: Payload too large Exception\n                    message: Maximum request body size limit exceeded\n                    path: /v1.0/vat/rates/country\n                    status: 413\n                    timestamp: '2026-07-27T11:46:29.925Z'\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\ncomponents:\n  securitySchemes:\n    ApiKeyAuthHeader:\n      type: apiKey\n      in: header\n      name: X-apiKey\n      description: Pass your API key via the X-apiKey request header.\n    ApiKeyAuthQuery:\n      type: apiKey\n      in: query\n      name: apiKey\n      description: Pass your API key via the apiKey query parameter.\n  schemas:\n    VatCountryBulkResponse:\n      type: array\n      description: Array of VAT rate results, one entry per country that resolved successfully, in request order. Countries that fail to resolve are omitted, so this array can be shorter than the requested countries list.\n      items:\n        $ref: '#/components/schemas/VatBulkResponseItem'\n    VatBulkResponseItem:\n      type: object\n      description: A VAT rate result for a single country or state in a bulk response.\n      required:\n        - country\n        - type\n        - currency\n        - standard_rate\n      properties:\n        country:\n          type: string\n          description: Country identifier returned in the result item.\n        state:\n          type: string\n          description: State or region returned for sub-national lookups. Only present when the request included a state.\n        type:\n          type: string\n          description: Tax type applied for the country or state.\n        currency:\n          type: string\n          description: ISO 4217 currency code for the returned location. Can be an empty string for some state-level entries.\n        standard_rate:\n          type: number\n          format: float\n          description: Standard VAT or sales tax rate for the returned location.\n        reduced_rate:\n          type: array\n          description: Reduced VAT rates when defined for the location.\n          items:\n            $ref: '#/components/schemas/VatRateDecimal'\n        super_reduced_rate:\n          type: array\n          description: Super-reduced VAT rates for specific categories, when defined.\n          items:\n            $ref: '#/components/schemas/VatRateDecimal'\n        parking_rate:\n          type: number\n          format: float\n          description: Parking rate, when applicable.\n        categories:\n          description: Category-specific VAT rates, where defined (EU/UK only).\n          $ref: '#/components/schemas/VatCategories'\n    VatRateDecimal:\n      type: number\n      format: float\n      description: A VAT rate expressed as a decimal (e.g., 0.19 = 19%).\n    VatCategories:\n      type: object\n      description: Category-specific VAT rates, where defined (EU/UK only). Keys vary by country.\n      properties:\n        books:\n          type: number\n          format: float\n          description: VAT rate for books, as a decimal (e.g., 0.07 = 7%).\n        newspapers:\n          type: number\n          format: float\n          description: VAT rate for newspapers, as a decimal (e.g., 0.07 = 7%).\n        periodicals:\n          type: number\n          format: float\n          description: VAT rate for periodicals, as a decimal (e.g., 0.07 = 7%).\n        broadcasting:\n          type: number\n          format: float\n          description: VAT rate for broadcasting services, as a decimal (e.g., 0.19 = 19%).\n    BulkVatRequest:\n      type: object\n      description: Request body for bulk VAT rate lookup by country.\n      required:\n        - countries\n      properties:\n        countries:\n          type: array\n          description: Array of country entries to look up. Maximum 100 entries.\n          items:\n            $ref: '#/components/schemas/BulkVatRequestItem'\n    BulkVatRequestItem:\n      type: object\n      description: A single country entry in a bulk VAT request.\n      required:\n        - country\n      properties:\n        country:\n          type: string\n          description: Country identifier in Alpha-2, Alpha-3, or full name.\n        state:\n          type: string\n          description: Optional state or region for sub-national VAT.\n    ErrorResponse:\n      type: object\n      description: Standard error envelope returned by the API on failed requests.\n      required:\n        - message\n      properties:\n        error:\n          type: string\n          description: Short error category or exception type.\n        message:\n          type: string\n          description: Human-readable error message describing the failure.\n        path:\n          type: string\n          description: API endpoint path that produced the error.\n        status:\n          type: integer\n          description: HTTP status code returned with the error.\n        timestamp:\n          type: string\n          format: date-time\n          description: Timestamp when the error occurred (ISO 8601).\n  headers:\n    X-AF-Credits-Cost:\n      description: Specifies the number of credits consumed by the current request.\n      schema:\n        type: integer\nsecurity:\n  - ApiKeyAuthHeader: []\n  - ApiKeyAuthQuery: []\n",
   "financial-apis-supported-countries": "openapi: 3.1.1\ninfo:\n  title: Financial APIs Supported Countries Reference\n  version: 1.0.0\n  description: Retrieve the countries and states supported by the VAT, IBAN, and SWIFT APIs. The response always includes all three categories \u2014 VAT_Supported_Countries_And_States, IBAN_Supported_Countries, and SWIFT_Supported_Countries \u2014 each with a different shape. VAT entries are keyed by lowercase country name and include an ISO code plus, for a handful of countries (US, Canada, Spain), a nested map of sub-national state/region codes. IBAN and SWIFT entries are flat arrays of {name, countryCode} objects.\n  contact:\n    name: APIFreaks Support\n    url: https://apifreaks.com/contact\n    email: support@apifreaks.com\nservers:\n  - url: https://api.apifreaks.com/v1.0\n    description: Financial APIs Supported Countries API Server\npaths:\n  /vat/supported-countries:\n    get:\n      tags:\n        - Financial APIs\n      summary: Get supported countries\n      description: Returns the countries and states supported by the VAT, IBAN, and SWIFT APIs.\n      operationId: getSupportedCountries\n      parameters:\n        - name: format\n          in: query\n          required: false\n          schema:\n            type: string\n            enum:\n              - json\n              - xml\n            default: json\n          description: Format of the response. Default is JSON.\n        - name: type\n          in: query\n          required: false\n          schema:\n            type: string\n          description: Accepted by the endpoint but currently has no effect \u2014 all three categories (VAT, IBAN, SWIFT) are always returned regardless of this value.\n      responses:\n        '200':\n          description: Successful response \u2014 always returns all three categories\n          content:\n            application/json:\n              schema:\n                $ref: '#/components/schemas/SupportedCountriesResponse'\n              examples:\n                typicalSuccess:\n                  summary: Typical successful response (truncated)\n                  value:\n                    VAT_Supported_Countries_And_States:\n                      - germany:\n                          code: de\n                      - united_states:\n                          code: us\n                          states:\n                            california: us:ca\n                            new_york: us:ny\n                            texas: us:tx\n                    IBAN_Supported_Countries:\n                      - countryCode: DE\n                        name: Germany\n                      - countryCode: GB\n                        name: United Kingdom\n                    SWIFT_Supported_Countries:\n                      - name: Germany\n                        countryCode: DE\n                      - name: United States\n                        countryCode: US\n          headers:\n            X-AF-Credits-Cost:\n              $ref: '#/components/headers/X-AF-Credits-Cost'\ncomponents:\n  securitySchemes:\n    ApiKeyAuthHeader:\n      type: apiKey\n      in: header\n      name: X-apiKey\n      description: Pass your API key via the X-apiKey request header.\n    ApiKeyAuthQuery:\n      type: apiKey\n      in: query\n      name: apiKey\n      description: Pass your API key via the apiKey query parameter.\n  schemas:\n    SupportedCountriesResponse:\n      type: object\n      description: Countries and states supported by the VAT, IBAN, and SWIFT APIs.\n      required:\n        - VAT_Supported_Countries_And_States\n        - IBAN_Supported_Countries\n        - SWIFT_Supported_Countries\n      properties:\n        VAT_Supported_Countries_And_States:\n          type: array\n          description: Array of single-key objects, one per supported VAT country. Each key is the lowercase, underscore-separated country name.\n          items:\n            type: object\n            description: A single VAT-supported country, keyed by its lowercase name.\n            additionalProperties:\n              title: VatCountryEntry\n              $ref: '#/components/schemas/VatCountryEntry'\n        IBAN_Supported_Countries:\n          type: array\n          description: Array of countries supported by the IBAN Validation API.\n          items:\n            $ref: '#/components/schemas/IbanCountryEntry'\n        SWIFT_Supported_Countries:\n          type: array\n          description: Array of countries supported by the SWIFT/BIC Code Lookup and Finder APIs.\n          items:\n            $ref: '#/components/schemas/SwiftCountryEntry'\n    VatCountryEntry:\n      type: object\n      description: 'VAT country metadata: an ISO 3166-1 alpha-2 code, plus an optional map of sub-national states/regions for countries with state-level VAT (US, Canada, Spain).'\n      required:\n        - code\n      properties:\n        code:\n          type: string\n          description: ISO 3166-1 alpha-2 country code, lowercase.\n        states:\n          type: object\n          description: Map of state/region name to its combined country:state code. Only present for countries with sub-national VAT rates.\n          additionalProperties:\n            title: StateCode\n            type: string\n            description: Combined country:state identifier (e.g. us:ca).\n    IbanCountryEntry:\n      type: object\n      description: A single country supported by the IBAN Validation API.\n      required:\n        - countryCode\n        - name\n      properties:\n        countryCode:\n          type: string\n          description: ISO 3166-1 alpha-2 country code.\n        name:\n          type: string\n          description: Full country name.\n    SwiftCountryEntry:\n      type: object\n      description: A single country supported by the SWIFT/BIC Code Lookup and Finder APIs.\n      required:\n        - name\n        - countryCode\n      properties:\n        name:\n          type: string\n          description: Full country name.\n        countryCode:\n          type: string\n          description: ISO 3166-1 alpha-2 country code.\n  headers:\n    X-AF-Credits-Cost:\n      description: Specifies the number of credits consumed by the current request.\n      schema:\n        type: integer\nsecurity:\n  - ApiKeyAuthHeader: []\n  - ApiKeyAuthQuery: []\n",
   "iban-validation": `openapi: 3.1.1
@@ -53529,7 +56889,7 @@ var SPECS_BY_CATEGORY = {
   "commodity": ["commodity-fluctuation", "commodity-prices", "commodity-symbols", "commodity-time-series", "historical-commodity-prices"],
   "currency": ["currency-converter", "currency-fluctuation", "currency-historical-data-limit", "currency-rate", "currency-supported", "currency-symbols", "currency-time-series", "geolocalized-currency-conversion", "historical-currency-converter", "historical-currency-rate"],
   "dns": ["bulk-dns-lookup", "dns-history-lookup", "dns-lookup", "reverse-dns-lookup"],
-  "domain": ["bulk-domain-checker", "domain-search-with-suggestions", "domain-search", "subdomain-lookup"],
+  "domain": ["bulk-domain-checker", "domain-reputation", "domain-search-with-suggestions", "domain-search", "domain-typosquatting", "subdomain-lookup"],
   "email-validation": ["bulk-email-validation", "email-checker"],
   "financial": ["bulk-vat-rates-country", "financial-apis-supported-countries", "iban-validation", "swift-code-finder", "swift-code-lookup", "vat-number-validation", "vat-rates-by-ip", "vat-rates-country"],
   "geocoding": ["forward-geocoding", "reverse-geocoding"],
@@ -53582,8 +56942,10 @@ var SpecSlug = {
   DELETE_PDF_PAGE: "delete-pdf-page",
   DNS_HISTORY_LOOKUP: "dns-history-lookup",
   DNS_LOOKUP: "dns-lookup",
+  DOMAIN_REPUTATION: "domain-reputation",
   DOMAIN_SEARCH: "domain-search",
   DOMAIN_SEARCH_WITH_SUGGESTIONS: "domain-search-with-suggestions",
+  DOMAIN_TYPOSQUATTING: "domain-typosquatting",
   DOMAIN_WHOIS_HISTORY_LOOKUP: "domain-whois-history-lookup",
   EMAIL_CHECKER: "email-checker",
   FINANCIAL_APIS_SUPPORTED_COUNTRIES: "financial-apis-supported-countries",
@@ -53682,9 +57044,6 @@ function getSpecJson(slug) {
 function getSpecYaml(slug) {
   return SPECS_YAML[slug];
 }
-function getSpec(slug) {
-  return getSpecJson(slug);
-}
 function getSpecsByCategory(category) {
   return SPECS_BY_CATEGORY[category] ?? [];
 }
@@ -53697,7 +57056,6 @@ function getSpecsByCategory(category) {
   SPEC_SLUGS,
   SpecCategory,
   SpecSlug,
-  getSpec,
   getSpecJson,
   getSpecYaml,
   getSpecsByCategory