@apifreaks/openapi-specs 0.2.0 → 0.3.1

package/dist/specs/dns/dns-history-lookup.yaml

@@ -246,6 +246,9 @@ paths:
                             rawText: "example.com.\t\t128\tIN\tNS\tb.iana-servers.net."
                             rRsetType: 2
                             singleName: b.iana-servers.net.
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Invalid DNS type or malformed hostname
           content:
@@ -269,6 +272,9 @@ paths:
                     error: Invalid Param Exception
                     message: 'Please pass domain param correct value[For Technical Support: support@whoisfreaks.com]'
                     path: /v2.0/dns/historical
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not Found — No DNS history records for the hostname
           content:
@@ -284,6 +290,9 @@ paths:
                     error: Record not Found
                     message: 'No Record Found across: zzsuperrandomnonexistent998877.com'
                     path: /v2.0/dns/historical
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -446,6 +455,11 @@ components:
           description: Verification or policy strings. Present only when dnsType is TXT or SPF.
           items:
             type: string
+  headers:
+    X-AF-Credits-Cost:
+      description: Specifies the number of credits consumed by the current request.
+      schema:
+        type: integer
 security:
   - ApiKeyAuthHeader: []
   - ApiKeyAuthQuery: []

package/dist/specs/dns/dns-lookup.yaml

@@ -175,6 +175,9 @@ paths:
                         rawText: "8.8.8.8.in-addr.arpa.\t16954\tIN\tPTR\tdns.google."
                         rRsetType: 12
                         singleName: dns.google.
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Missing or invalid parameters
           content:
@@ -206,6 +209,9 @@ paths:
                     error: Invalid Param Exception
                     message: 'Please pass domain param correct value[For Technical Support: support@whoisfreaks.com]'
                     path: /v2.0/dns/live
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -355,6 +361,11 @@ components:
           type: string
           format: date-time
           description: Timestamp when the error occurred (ISO 8601).
+  headers:
+    X-AF-Credits-Cost:
+      description: Specifies the number of credits consumed by the current request.
+      schema:
+        type: integer
 security:
   - ApiKeyAuthHeader: []
   - ApiKeyAuthQuery: []

package/dist/specs/dns/reverse-dns-lookup.yaml

@@ -124,6 +124,13 @@ paths:
                             rawText: "www.hailibu.cn.\t\t1\tIN\tA\t8.8.8.8"
                             rRsetType: 1
                             address: 8.8.8.8
+          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: Invalid DNS type or missing required parameter
           content:
@@ -147,6 +154,13 @@ paths:
                     path: /v1.0/domain/dns/reverse
                     status: 400
                     timestamp: '2026-07-23T09:51:58.951Z'
+          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: No reverse DNS records found for the given input
           content:
@@ -162,6 +176,13 @@ paths:
                     status: 404
                     error: Record not Found
                     message: 'No Record Found across: zzsuperrandomnonexistentmxprovider99988.com'
+          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'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -333,6 +354,19 @@ components:
           description: Verification or policy strings. Present only when dnsType is TXT or SPF.
           items:
             type: string
+  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: []

package/dist/specs/domain/bulk-domain-checker.yaml

@@ -71,6 +71,9 @@ paths:
                       - domain: thisdomainisdefinitelyavailablexyz123abc.com
                         domainAvailability: true
                         status: true
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '206':
           description: Partial Success — one or more domains in the batch failed to resolve. Failed entries have status false and no domainAvailability field. Even a batch where every domain fails still returns 206, not an error status.
           content:
@@ -89,6 +92,9 @@ paths:
                         status: true
                       - domain: test.an
                         status: false
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Missing or malformed request body
           content:
@@ -104,6 +110,9 @@ paths:
                     path: /v1.0/domain/availability
                     status: 400
                     timestamp: '2026-07-27T12:23:33.394Z'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '413':
           description: Payload Too Large — Request body exceeds the size limit
           content:
@@ -119,6 +128,9 @@ paths:
                     path: /v1.0/domain/availability
                     status: 413
                     timestamp: '2026-07-27T12:23:46.923Z'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -193,6 +205,11 @@ components:
           type: string
           format: date-time
           description: Timestamp when the error occurred (ISO 8601).
+  headers:
+    X-AF-Credits-Cost:
+      description: Specifies the number of credits consumed by the current request.
+      schema:
+        type: integer
 security:
   - ApiKeyAuthHeader: []
   - ApiKeyAuthQuery: []

package/dist/specs/domain/domain-search-with-suggestions.yaml

@@ -88,6 +88,9 @@ paths:
                   value:
                     domain: quixoticbramble77.com
                     domainAvailability: true
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request – Invalid domain parameter
           content:
@@ -103,6 +106,9 @@ paths:
                     path: /v1.0/domain/availability/suggestions
                     status: 400
                     timestamp: '2026-07-27T12:19:46.594Z'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '408':
           description: Request Timeout – Unable to fetch WHOIS data
           content:
@@ -118,6 +124,9 @@ paths:
                     error: Request Timeout
                     message: 'Unable to fetch whois data. Please try again. [For Technical Support email at: support@apifreaks.com]'
                     path: /v1.0/domain/availability/suggestions
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
       operationId: suggestDomainAvailability
 components:
   securitySchemes:
@@ -191,6 +200,11 @@ components:
           type: string
           format: date-time
           description: Timestamp when the error occurred (ISO 8601).
+  headers:
+    X-AF-Credits-Cost:
+      description: Specifies the number of credits consumed by the current request.
+      schema:
+        type: integer
 security:
   - ApiKeyAuthHeader: []
   - ApiKeyAuthQuery: []

package/dist/specs/domain/domain-search.yaml

@@ -57,6 +57,9 @@ paths:
                   value:
                     domain: google.com
                     domainAvailability: false
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request – Missing domain, or domain has an unrecognized/unsupported TLD
           content:
@@ -80,6 +83,9 @@ paths:
                     error: Invalid Param Exception
                     message: 'Please pass domain param correct value [For Technical Support: support@whoisfreaks.com]'
                     path: /v1.0/domain/availability
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '408':
           description: Request Timeout – Unable to fetch WHOIS data
           content:
@@ -95,6 +101,9 @@ paths:
                     error: Request Timeout
                     message: 'Unable to fetch whois data. Please try again. [For Technical Support email at: support@apifreaks.com]'
                     path: /v1.0/domain/availability
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
       operationId: checkDomainAvailability
 components:
   securitySchemes:
@@ -144,6 +153,11 @@ components:
           type: string
           format: date-time
           description: Timestamp when the error occurred (ISO 8601).
+  headers:
+    X-AF-Credits-Cost:
+      description: Specifies the number of credits consumed by the current request.
+      schema:
+        type: integer
 security:
   - ApiKeyAuthHeader: []
   - ApiKeyAuthQuery: []

package/dist/specs/domain/subdomain-lookup.yaml

@@ -91,6 +91,9 @@ paths:
                       - subdomain: www.reusablesec.sites.google.com
                         first_seen: '2020-02-18'
                         last_seen: '2026-06-20'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request – one or more parameters are invalid
           content:
@@ -138,6 +141,9 @@ paths:
                     error: Invalid Param Exception
                     message: before date cannot be greater than the current date.
                     path: /v1.0/subdomains
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '408':
           description: Request Timeout – Unable to fetch WHOIS data
           content:
@@ -153,6 +159,9 @@ paths:
                     error: Request Timeout
                     message: 'Unable to fetch whois data. Please try again. [For Technical Support email at: support@apifreaks.com]'
                     path: /v1.0/subdomains/lookup
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
       operationId: lookupSubdomains
 components:
   securitySchemes:
@@ -246,6 +255,11 @@ components:
           type: string
           format: date-time
           description: Timestamp when the error occurred (ISO 8601).
+  headers:
+    X-AF-Credits-Cost:
+      description: Specifies the number of credits consumed by the current request.
+      schema:
+        type: integer
 security:
   - ApiKeyAuthHeader: []
   - ApiKeyAuthQuery: []

package/dist/specs/email-validation/bulk-email-validation.yaml

@@ -2,7 +2,7 @@ openapi: 3.1.1
 info:
   title: Bulk Email Validation API - Validate and Verify Emails in Bulk
   version: 1.0.0
-  description: Validate up to 100 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 100 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, plus per-item error objects for failed validations. Maximum 10 email addresses per request.
   contact:
     name: APIFreaks Support
     url: https://apifreaks.com/contact
@@ -16,7 +16,7 @@ paths:
       tags:
         - Email Validation APIs
       summary: Validate multiple email addresses
-      description: Validates a bulk of email addresses and returns result for each. Maximum `100` email addresses per request.
+      description: Validates a bulk of email addresses and returns result for each. Maximum `10` email addresses per request.
       parameters:
         - name: format
           in: query
@@ -45,7 +45,7 @@ paths:
                 bulkEmailsValidated:
                   summary: Mix of a valid and a syntactically invalid email
                   value:
-                    emailValidationResponses:
+                    emailResponse:
                       - success: true
                         email: abc.def@gmail.com
                         validEmail: valid
@@ -61,7 +61,7 @@ paths:
                           role: false
                           fullMailBox: false
                         dns:
-                          mxRecords:
+                          mxRecord:
                             - gmail-smtp-in.l.google.com.
                             - alt1.gmail-smtp-in.l.google.com.
                             - alt2.gmail-smtp-in.l.google.com.
@@ -74,6 +74,13 @@ paths:
                         domain:
                           name: not-an-email
                           validDomain: false
+          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 – Invalid request body
           content:
@@ -89,6 +96,26 @@ paths:
                     status: 400
                     error: Invalid request body Exception
                     message: Please provide data in required format in request body
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
+        '404':
+          description: Not Found – The requested resource could not be found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+              examples:
+                Resource Not Found:
+                  value:
+                    timestamp: '2026-09-02T11:57:55.592Z'
+                    path: /v1.0/email-validation/bulkx
+                    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'
         '408':
           description: Request Timeout
           content:
@@ -103,6 +130,26 @@ paths:
                     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'
+        '413':
+          description: Payload Too Large – emailData exceeds the maximum of 10 entries per request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+              examples:
+                Payload Too Large:
+                  value:
+                    timestamp: '2026-09-02T11:57:34.223Z'
+                    path: /v2/email-validation/bulk
+                    status: 413
+                    error: Payload too large Exception
+                    message: Maximum request body size limit exceeded
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '429':
           description: Rate Limit Exceeded
           content:
@@ -117,6 +164,9 @@ paths:
                     status: 429
                     error: Too Many Requests
                     message: API rate limit exceeded.
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
       operationId: bulkCheckEmail
 components:
   securitySchemes:
@@ -135,9 +185,9 @@ components:
       type: object
       description: Wrapper containing the per-email results array.
       required:
-        - emailValidationResponses
+        - emailResponse
       properties:
-        emailValidationResponses:
+        emailResponse:
           type: array
           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.
           items:
@@ -172,7 +222,8 @@ components:
             - INVALID_EMAIL
             - unknown
             - risky
-          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. unknown/risky are documented possibilities not observed during testing.'
+            - 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).'
         validSyntax:
           type: boolean
           description: Validates email address format compliance with RFC 5322 standards.
@@ -229,14 +280,14 @@ components:
     DnsObject:
       type: object
       required:
-        - mxRecords
+        - mxRecord
       properties:
-        mxRecords:
+        mxRecord:
           type: array
           items:
             type: string
           description: Collection of MX (Mail Exchange) hostname records from DNS queries.
-        aRecords:
+        aRecord:
           type: array
           items:
             type: string
@@ -355,8 +406,8 @@ components:
       properties:
         emailData:
           type: array
-          description: Array of email objects to validate. Maximum 100 per request.
-          maxItems: 100
+          description: Array of email objects to validate. Maximum 10 per request.
+          maxItems: 10
           items:
             $ref: '#/components/schemas/BulkEmailRequestItem'
     BulkEmailRequestItem:
@@ -398,6 +449,19 @@ components:
           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: []

package/dist/specs/email-validation/email-checker.yaml

@@ -2,7 +2,7 @@ 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/invalid/unknown/risky 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/invalid/unknown/risky/app_server_blocked status.
   contact:
     name: APIFreaks Support
     url: https://apifreaks.com/contact
@@ -59,7 +59,7 @@ paths:
                       role: false
                       fullMailBox: false
                     dns:
-                      mxRecords:
+                      mxRecord:
                         - gmail-smtp-in.l.google.com.
                         - alt1.gmail-smtp-in.l.google.com.
                         - alt2.gmail-smtp-in.l.google.com.
@@ -110,7 +110,7 @@ paths:
                       role: false
                       fullMailBox: false
                     dns:
-                      mxRecords:
+                      mxRecord:
                         - gmail-smtp-in.l.google.com.
                         - alt1.gmail-smtp-in.l.google.com.
                         - alt2.gmail-smtp-in.l.google.com.
@@ -145,6 +145,33 @@ paths:
                         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 – Invalid request body
           content:
@@ -155,11 +182,39 @@ paths:
                 missingEmail:
                   summary: email field missing from request body
                   value:
-                    timestamp: '2026-07-27T12:51:23.593986185Z'
-                    path: /v2.0/email-validation/single
+                    timestamp: '2026-09-02T11:56:23.462Z'
+                    path: /v2/email-validation/single
                     status: 400
-                    error: External API Error
+                    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 – 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:
@@ -174,6 +229,13 @@ paths:
                     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:
@@ -188,6 +250,13 @@ paths:
                     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:
@@ -232,7 +301,8 @@ components:
             - INVALID_EMAIL
             - unknown
             - risky
-          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. unknown/risky are documented possibilities not observed during testing.'
+            - 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).'
         validSyntax:
           type: boolean
           description: Validates email address format compliance with RFC 5322 standards.
@@ -289,14 +359,14 @@ components:
     DnsObject:
       type: object
       required:
-        - mxRecords
+        - mxRecord
       properties:
-        mxRecords:
+        mxRecord:
           type: array
           items:
             type: string
           description: Collection of MX (Mail Exchange) hostname records from DNS queries.
-        aRecords:
+        aRecord:
           type: array
           items:
             type: string
@@ -446,6 +516,19 @@ components:
           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: []