@apifreaks/openapi-specs 0.2.0 → 0.3.0

package/dist/specs/commodity/commodity-fluctuation.yaml

@@ -71,6 +71,9 @@ paths:
                         endRate: 2039.83
                         change: -23.8
                         changePercent: -1.15
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Missing parameters or invalid dates
           content:
@@ -110,6 +113,9 @@ paths:
                     message: Start date cannot be after end date
               schema:
                 $ref: '#/components/schemas/ErrorResponse'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not found - Symbol or data not available
           content:
@@ -133,6 +139,9 @@ paths:
                     code: 404
                     error: DATA_NOT_FOUND
                     message: No data found for the given date range
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -220,6 +229,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/commodity/commodity-prices.yaml

@@ -84,6 +84,9 @@ paths:
                       XAU:
                         unit: T.oz
                         quote: EUR
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Missing or invalid query parameters
           content:
@@ -107,6 +110,9 @@ paths:
                     path: /v1.0/commodity/rates/latest
                     status: 400
                     timestamp: '2026-07-27T11:36:35.755Z'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not found - Symbol or quote currency not available
           content:
@@ -130,6 +136,9 @@ paths:
                     code: 404
                     error: QUOTE_NOT_FOUND
                     message: The quote currency is invalid, please visit the documentation for a list of valid quote currencies
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -231,6 +240,11 @@ components:
         message:
           type: string
           description: Human-readable error message describing the failure.
+  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/commodity/commodity-symbols.yaml

@@ -65,6 +65,9 @@ paths:
                         unit:
                           symbol: MMBtu
                           name: Million British Thermal Units
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -154,6 +157,11 @@ components:
         name:
           type: string
           description: Full name of the unit of measurement (e.g., Troy Ounce).
+  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/commodity/commodity-time-series.yaml

@@ -79,6 +79,9 @@ paths:
                           high: 2674.68
                           low: 2668.58
                           close: 2671.8
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Missing parameters, invalid dates, or date range exceeded
           content:
@@ -118,6 +121,9 @@ paths:
                     message: Date range exceeds the allowed limit.
               schema:
                 $ref: '#/components/schemas/ErrorResponse'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not found - Symbol or data not available
           content:
@@ -141,6 +147,9 @@ paths:
                     code: 404
                     error: DATA_NOT_FOUND
                     message: No data found for the specified date range
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -233,6 +242,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/commodity/historical-commodity-prices.yaml

@@ -66,6 +66,9 @@ paths:
                         high: 2697.85
                         low: 2663.61
                         close: 2689.44
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad request - Invalid date format
           content:
@@ -89,6 +92,9 @@ paths:
                     error: VALIDATION_ERROR
                     message: 'Invalid Date: The provided date does not exist.'
                     path: /v1.0/commodity/rates/historical
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not found - Symbol or rate not available
           content:
@@ -112,6 +118,9 @@ paths:
                     error: RATE_NOT_FOUND
                     message: no rates found for the specified date
                     path: /v1.0/commodity/rates/historical
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -203,6 +212,11 @@ components:
           type: string
           description: API endpoint path that produced the error.
       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/currency/currency-converter.yaml

@@ -77,6 +77,9 @@ paths:
                     rate: '0.87800'
                     givenAmount: '100.0'
                     convertedAmount: '87.800'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad request - Invalid amount or updates parameter
           content:
@@ -108,6 +111,9 @@ paths:
                     error: Invalid Param Exception
                     message: Please provide valid updates parameter (1d,1h,10m,1m)
                     path: /v2.0/convert/latest
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not found - Currency not available
           content:
@@ -123,6 +129,9 @@ paths:
                     error: Not Found Exception
                     message: Rates of provided currency ZZZ are not available in our database!
                     path: /v2.0/convert/latest
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -188,6 +197,11 @@ components:
         path:
           type: string
           description: API endpoint path (gateway errors) or internal service path (currency-service errors) that produced the error.
+  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/currency/currency-fluctuation.yaml

@@ -79,6 +79,9 @@ paths:
                         endRate: '278.650'
                         change: '-0.25'
                         percentChange: '-0.09'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad request - Invalid dates
           content:
@@ -110,6 +113,9 @@ paths:
                     error: Invalid Param Exception
                     message: Provided Dates are in Invalid Format. Dates must be in a valid format YYYY-MM-DD!
                     path: /v2.0/fluctuation
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not found - No data for interval
           content:
@@ -125,6 +131,9 @@ paths:
                     error: Not Found Exception
                     message: Rates of provided base and symbols are not found for given intervals.
                     path: /v2.0/fluctuation
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -206,6 +215,11 @@ components:
         path:
           type: string
           description: API endpoint path (gateway errors) or internal service path (currency-service errors) that produced the error.
+  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/currency/currency-historical-data-limit.yaml

@@ -44,6 +44,9 @@ paths:
                       FJD: 1989-08-18 to 2026-07-27
                       SCR: 1998-07-31 to 2026-07-27
                       STPT: 2025-02-27 to 2025-05-28
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '406':
           description: Unsupported Media Type — format is not json or xml
           content:
@@ -59,6 +62,9 @@ paths:
                     path: /v1.0/currency/historical/data/limits
                     status: 406
                     timestamp: '2026-07-27T12:14:01.189Z'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -107,6 +113,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/currency/currency-rate.yaml

@@ -70,6 +70,9 @@ paths:
                     rates:
                       EUR: '0.878156'
                       PKR: '277.863'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad request - Invalid parameters
           content:
@@ -85,6 +88,9 @@ paths:
                     error: Invalid Param Exception
                     message: Please provide valid updates parameter (1d,1h,10m,1m)
                     path: /v2.0/rates/latest
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not found - Currency or symbol not available
           content:
@@ -108,6 +114,9 @@ paths:
                     error: Not Found Exception
                     message: Rates of provided Symbols are not available in our database!
                     path: /v2.0/rates/latest
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -168,6 +177,11 @@ components:
           type: string
           description: API endpoint path that produced the error.
       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/currency/currency-supported.yaml

@@ -68,6 +68,9 @@ paths:
                         availableFrom: '2020-01-01'
                         availableUntil: '2026-06-18'
                         icon: https://currencyfreaks.com/photos/flags/xau.png
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '406':
           description: Unsupported Media Type — format is not json or xml
           content:
@@ -83,6 +86,9 @@ paths:
                     path: /v1.0/currency/supported
                     status: 406
                     timestamp: '2026-07-27T12:12:35.587Z'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -171,6 +177,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/currency/currency-symbols.yaml

@@ -47,6 +47,9 @@ paths:
                       PKR: Pakistani Rupee
                       BTC: Bitcoin
                       XAU: Gold (troy ounce)
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '406':
           description: Unsupported Media Type — format is not json or xml
           content:
@@ -62,6 +65,9 @@ paths:
                     path: /v1.0/currency/symbols
                     status: 406
                     timestamp: '2026-07-27T12:13:24.369Z'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -110,6 +116,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/currency/currency-time-series.yaml

@@ -97,6 +97,9 @@ paths:
                         rates:
                           EUR: '0.967'
                           PKR: '278.4'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad request - Invalid dates or range exceeded
           content:
@@ -136,6 +139,9 @@ paths:
                     error: Invalid Param Exception
                     message: Provided Dates are in Invalid Format. Dates must be in a valid format YYYY-MM-DD!
                     path: /v2.0/timeseries
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not found - No data for interval
           content:
@@ -151,6 +157,9 @@ paths:
                     error: Not Found Exception
                     message: Rates of provided base and symbols are not found for given intervals.
                     path: /v2.0/timeseries
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -227,6 +236,11 @@ components:
         path:
           type: string
           description: API endpoint path (gateway errors) or internal service path (currency-service errors) that produced the error.
+  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/currency/geolocalized-currency-conversion.yaml

@@ -78,6 +78,9 @@ paths:
                     ipAddress: 182.186.18.91
                     givenAmount: '100.0'
                     convertedAmount: '27786.300'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad request - Invalid IP, amount, or updates
           content:
@@ -117,6 +120,9 @@ paths:
                     error: Invalid Param Exception
                     message: Please provide valid updates parameter (1d,1h,10m,1m)
                     path: /v2.0/iptocurrency
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not found - IP geolocation or currency not available
           content:
@@ -140,6 +146,9 @@ paths:
                     error: Not Found Exception
                     message: Rates of provided currency ZZZ are not available in our database!
                     path: /v2.0/iptocurrency
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -209,6 +218,11 @@ components:
         path:
           type: string
           description: API endpoint path (gateway errors) or internal service path (currency-service errors) that produced the error.
+  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/currency/historical-currency-converter.yaml

@@ -71,6 +71,9 @@ paths:
                     rate: '0.97620'
                     givenAmount: '100.0'
                     convertedAmount: '97.620'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad request - Invalid amount or date format
           content:
@@ -102,6 +105,9 @@ paths:
                     error: Invalid Param Exception
                     message: Provided Date 10-01-2025 is in invalid format. It should be like  YYYY-MM-DD!
                     path: /v2.0/convert/historical
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not found - Currency or date not available
           content:
@@ -125,6 +131,9 @@ paths:
                     error: Not Found Exception
                     message: Rates of provided currency ZZZ are not available in our database!
                     path: /v2.0/convert/historical
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -190,6 +199,11 @@ components:
         path:
           type: string
           description: API endpoint path (gateway errors) or internal service path (currency-service errors) that produced the error.
+  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/currency/historical-currency-rate.yaml

@@ -64,6 +64,9 @@ paths:
                     rates:
                       EUR: '0.9762'
                       PKR: '278.65'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Missing or malformed date
           content:
@@ -87,6 +90,9 @@ paths:
                     error: Invalid Param Exception
                     message: Provided Date 10-01-2025 is in invalid format. It should be like  YYYY-MM-DD!
                     path: /v2.0/rates/historical
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not found - Currency, symbol, or date not available
           content:
@@ -118,6 +124,9 @@ paths:
                     error: Not Found Exception
                     message: Rates of provided Symbols are not available in our database!
                     path: /v2.0/rates/historical
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -175,6 +184,11 @@ components:
             - string
             - integer
           description: Timestamp when the error occurred — ISO 8601 string for gateway errors, Unix milliseconds integer for currency-service errors.
+  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/bulk-dns-lookup.yaml

@@ -262,6 +262,9 @@ paths:
                             rRsetType: 99
                             strings:
                               - v=spf1 -all
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Missing type parameter or malformed request body
           content:
@@ -285,6 +288,9 @@ paths:
                     path: /v1.0/domain/dns/live
                     status: 400
                     timestamp: '2026-07-23T09:52:49.074Z'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '413':
           description: Payload Too Large — Request exceeds the 100-hostname batch limit
           content:
@@ -300,6 +306,9 @@ paths:
                     path: /v1.0/domain/dns/live
                     status: 413
                     timestamp: '2026-07-23T09:52:49.621Z'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -479,6 +488,11 @@ components:
         message:
           type: string
           description: Error message.
+  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-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: []