@apifreaks/openapi-specs 0.2.0 → 0.3.0

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

@@ -74,6 +74,9 @@ paths:
                         domain:
                           name: not-an-email
                           validDomain: false
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request – Invalid request body
           content:
@@ -89,6 +92,9 @@ 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'
         '408':
           description: Request Timeout
           content:
@@ -103,6 +109,9 @@ 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'
         '429':
           description: Rate Limit Exceeded
           content:
@@ -117,6 +126,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:
@@ -398,6 +410,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/email-checker.yaml

@@ -145,6 +145,13 @@ paths:
                         is_bot: false
                         is_cloud_provider: true
                         cloud_provider: Google LLC
+          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:
@@ -160,6 +167,13 @@ paths:
                     status: 400
                     error: External API Error
                     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'
         '408':
           description: Request Timeout
           content:
@@ -174,6 +188,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 +209,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:
@@ -446,6 +474,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/financial/bulk-vat-rates-country.yaml

@@ -86,6 +86,9 @@ paths:
                         newspapers: 0.07
                         periodicals: 0.07
                         broadcasting: 0
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Missing or malformed request body
           content:
@@ -101,6 +104,9 @@ paths:
                     path: /v1.0/vat/rates/country
                     status: 400
                     timestamp: '2026-07-27T11:46:29.315Z'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '413':
           description: Payload Too Large — Request body exceeds the size limit
           content:
@@ -116,6 +122,9 @@ paths:
                     path: /v1.0/vat/rates/country
                     status: 413
                     timestamp: '2026-07-27T11:46:29.925Z'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -245,6 +254,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/financial/financial-apis-supported-countries.yaml

@@ -65,6 +65,9 @@ paths:
                         countryCode: DE
                       - name: United States
                         countryCode: US
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -147,6 +150,11 @@ components:
         countryCode:
           type: string
           description: ISO 3166-1 alpha-2 country code.
+  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/financial/iban-validation.yaml

@@ -111,6 +111,9 @@ paths:
                       address: null
                       account: null
                       sepa: null
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request
           content:
@@ -126,6 +129,9 @@ paths:
                     path: /v1.0/iban/validation
                     status: 400
                     timestamp: '2026-07-27T11:49:29.286Z'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
       operationId: validateIban
 components:
   securitySchemes:
@@ -265,6 +271,11 @@ components:
           format: date-time
           description: Timestamp when the error occurred (ISO 8601).
       description: Standard error envelope returned by the API on failed requests.
+  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/financial/swift-code-finder.yaml

@@ -87,6 +87,9 @@ paths:
                 noMatch:
                   summary: Unmatched country/bank/city — empty array, not an error
                   value: []
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Parameters supplied out of order
           content:
@@ -98,6 +101,9 @@ paths:
                   summary: bank supplied without country
                   value:
                     message: 'Invalid query parameters. Provide parameters in sequence: country → bank → city'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -141,6 +147,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/financial/swift-code-lookup.yaml

@@ -52,6 +52,9 @@ paths:
                     bankName: NATIONAL WESTMINSTER BANK PLC
                     city: LONDON
                     country: United Kingdom
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request
           content:
@@ -71,6 +74,9 @@ paths:
                   summary: swiftCode is not 8 or 11 characters
                   value:
                     message: 'Bad request: SWIFT code input must be either 8 characters or 11 characters'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not Found
           content:
@@ -82,6 +88,9 @@ paths:
                   summary: SWIFT code not found
                   value:
                     message: No bank found with the provided SWIFT code
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
       operationId: lookupSwiftCode
 components:
   securitySchemes:
@@ -151,6 +160,11 @@ components:
           format: date-time
           description: Timestamp when the error occurred (ISO 8601).
       description: Standard error envelope returned by the API on failed requests.
+  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/financial/vat-number-validation.yaml

@@ -75,6 +75,9 @@ paths:
                     company:
                       company_name: EVENTURED LTD
                       company_address: SUITE 10, BEAUFORT COURT, ADMIRALS WAY, LONDON, E14 9XL, GB
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request
           content:
@@ -94,6 +97,9 @@ paths:
                   summary: Unsupported VAT country code
                   value:
                     message: Unsupported VAT country code. Supported prefixes are UK/GB and EU VAT country codes.
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not Found
           content:
@@ -105,6 +111,9 @@ paths:
                   summary: VAT number not found
                   value:
                     message: targetVrn does not match a registered company
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
       operationId: validateVatNumber
 components:
   securitySchemes:
@@ -200,6 +209,11 @@ components:
           format: date-time
           description: Timestamp when the error occurred (ISO 8601).
       description: Standard error envelope returned by the API on failed requests.
+  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/financial/vat-rates-by-ip.yaml

@@ -66,6 +66,9 @@ paths:
                       type: vat
                       currency: ''
                       standard_rate: 0.0825
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request
           content:
@@ -77,6 +80,9 @@ paths:
                   summary: Invalid IP address format
                   value:
                     message: Invalid IP address format. Please provide a valid IPv4 or IPv6 address.
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not Found
           content:
@@ -88,6 +94,9 @@ paths:
                   summary: VAT data not found for IP
                   value:
                     message: No VAT data found. Please provide a valid ipAddress.
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -195,6 +204,11 @@ components:
           format: date-time
           description: Timestamp when the error occurred (ISO 8601).
       description: Standard error envelope returned by the API on failed requests.
+  headers:
+    X-AF-Credits-Cost:
+      description: Specifies the number of credits consumed by the current request.
+      schema:
+        type: integer
 security:
   - ApiKeyAuthHeader: []
   - ApiKeyAuthQuery: []