npm - @apifreaks/openapi-specs - Versions diffs - 0.4.0 → 0.4.1 - Mend

@apifreaks/openapi-specs 0.4.0 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/index.cjs +765 -22
package/dist/index.js +765 -22
package/dist/specs/email-validation/bulk-email-validation.yaml +64 -10
package/dist/specs/email-validation/email-checker.yaml +74 -11
package/package.json +1 -1
package/specs/email-validation/bulk-email-validation.json +78 -9
package/specs/email-validation/email-checker.json +88 -11

package/dist/index.js CHANGED Viewed

@@ -9366,7 +9366,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",
@@ -9418,7 +9418,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: [
                         {
@@ -9457,6 +9457,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"]
+                          }
                         }
                       ]
                     }
@@ -9661,19 +9729,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",
@@ -9725,7 +9794,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."
@@ -9747,24 +9816,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",
@@ -10007,7 +10076,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",
@@ -10100,8 +10169,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",
@@ -10121,6 +10190,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: {
@@ -10391,12 +10537,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",
@@ -10448,7 +10594,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."
@@ -10470,24 +10616,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",
@@ -52838,8 +52984,605 @@ security:
   - 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