@apifreaks/openapi-specs 0.1.2 → 0.3.0

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

@@ -356,6 +356,9 @@ paths:
                         date_time_after: 2026-11-01 TIME 01:00
                         date_time_before: 2026-11-01 TIME 02:00
                         overlap: true
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Invalid coordinates, timezone name, IP address, or airport code
           content:
@@ -383,6 +386,9 @@ paths:
                   summary: Invalid ICAO code
                   value:
                     message: 'Invalid ICAO code: INVALID. ICAO code must be in the format of AAAA.'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not Found — Location address not found, or LO code has no matching data
           content:
@@ -398,6 +404,9 @@ paths:
                   summary: UN/LOCODE not found
                   value:
                     message: '''Data not found for the provided LO code: XXXXX Please contact at support@ipgeolocation.io if provided LO code exists.'''
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -707,6 +716,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/user-agent/bulk-user-agent-parser.yaml

@@ -162,6 +162,9 @@ paths:
                         version: ??
                         version_major: ??
                         build: ??
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Invalid/missing request body, or an empty/null string anywhere in uaStrings (fails the whole batch, not a per-item error)
           content:
@@ -181,6 +184,9 @@ paths:
                   summary: Empty string or null inside uaStrings array
                   value:
                     message: '''userAgentString'' must not be empty or null'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -335,6 +341,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/user-agent/user-agent-parser.yaml

@@ -115,6 +115,9 @@ paths:
                       version: Hacker
                       version_major: Hacker
                       build: ??
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Missing or empty User-Agent header
           content:
@@ -130,6 +133,9 @@ paths:
                     path: /v1.0/user-agent/lookup
                     status: 400
                     timestamp: '2026-07-24T10:12:15.828Z'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -266,6 +272,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/weather/air-quality.yaml

@@ -157,6 +157,9 @@ paths:
                             uv_index: 0
                             aerosol_optical_depth: 0.2
                             uv_index_clear_sky: 0
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Invalid or incomplete parameters
           content:
@@ -220,6 +223,9 @@ paths:
                     message: Forecast date range must be within 2026-07-24 to 2026-07-29
                     error: params-exception-error
                     path: /v1.0/weather/air-quality
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not Found — Location could not be resolved
           content:
@@ -235,6 +241,9 @@ paths:
                     message: Location not found
                     error: error
                     path: /v1.0/weather/air-quality
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -585,6 +594,11 @@ components:
           description: Array of hourly air quality readings for this day.
           items:
             $ref: '#/components/schemas/AirQualityHourly'
+  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/weather/bulk-live-weather.yaml

@@ -122,6 +122,9 @@ paths:
                     bulk:
                       - error: Missing required location parameters
                       - error: Location not found
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Missing/malformed request body, or a non-object item in the locations array
           content:
@@ -145,6 +148,9 @@ paths:
                     message: '"locations[0]" must be of type object'
                     error: error
                     path: /v1.0/weather/current/bulk
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
       operationId: bulkLiveWeather
 components:
   securitySchemes:
@@ -649,6 +655,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/weather/flood-forecast.yaml

@@ -168,6 +168,9 @@ paths:
                           river_discharge_min: 0
                           river_discharge_p25: 0
                           river_discharge_p75: 0
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Missing, malformed, or out-of-range parameters
           content:
@@ -239,6 +242,9 @@ paths:
                     message: Forecast date range must be within 2026-07-24 to 2026-08-08
                     error: params-exception-error
                     path: /v1.0/weather/flood
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not Found — Location could not be resolved
           content:
@@ -254,6 +260,9 @@ paths:
                     message: Location not found
                     error: error
                     path: /v1.0/weather/flood
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -514,6 +523,11 @@ components:
       properties:
         daily:
           $ref: '#/components/schemas/FloodDaily'
+  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/weather/historical-weather.yaml

@@ -194,6 +194,9 @@ paths:
                         moonrise: '01:15'
                         moonset: '12:19'
                         moon_status: '-'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request --- Missing/invalid date, missing/incomplete lat+long pair, coordinates out of range, invalid IP address, invalid precision, or invalid timezone
           content:
@@ -265,6 +268,9 @@ paths:
                     message: Check whether your input value is correct; timezone = NotATimezone
                     error: error
                     path: /v1.0/weather/historical
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not Found --- Location could not be resolved
           content:
@@ -280,6 +286,9 @@ paths:
                     message: Location not found
                     error: error
                     path: /v1.0/weather/historical
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -837,6 +846,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/weather/live-weather.yaml

@@ -123,6 +123,9 @@ paths:
                         moonrise: '12:41'
                         moonset: '22:28'
                         moon_status: '-'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Missing/incomplete lat+long pair, coordinates out of range, invalid timezone, or invalid IP address
           content:
@@ -162,6 +165,9 @@ paths:
                     message: Invalid IP address
                     error: invalid-params
                     path: /v1.0/weather/current
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not Found — Location address could not be resolved
           content:
@@ -177,6 +183,9 @@ paths:
                     message: Location not found
                     error: error
                     path: /v1.0/weather/current
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -628,6 +637,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/weather/marine-weather.yaml

@@ -193,6 +193,9 @@ paths:
                           swell_wave_direction_dominant: 218
                           swell_wave_period_max: 4.7
                           swell_wave_peak_period_max: 6.3
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — invalid or incomplete parameters
           content:
@@ -248,6 +251,9 @@ paths:
                     path: /v1.0/weather/marine
                     status: 400
                     timestamp: '2026-07-24T11:35:30.525Z'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not Found — location could not be resolved
           content:
@@ -263,6 +269,9 @@ paths:
                     message: Location not found
                     error: error
                     path: /v1.0/weather/marine
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -801,6 +810,11 @@ components:
           description: Array of minute-by-minute marine data points for the day. Present when precision=minutely.
           items:
             $ref: '#/components/schemas/MarineMinutely'
+  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/weather/time-series-weather.yaml

@@ -203,6 +203,9 @@ paths:
                           moonrise: '12:18'
                           moonset: '23:04'
                           moon_status: '-'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Missing/invalid parameters, invalid date range, or location could not be resolved
           content:
@@ -306,6 +309,9 @@ paths:
                     message: Check whether your input value is correct; timezone = NotATimezone
                     error: error
                     path: /v1.0/weather/time-series
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -816,6 +822,11 @@ components:
           $ref: '#/components/schemas/TimeSeriesDay'
       required:
         - date
+  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/weather/weather-forecast.yaml

@@ -221,6 +221,9 @@ paths:
                           moonrise: '15:08'
                           moonset: '00:26'
                           moon_status: '-'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — invalid, missing, or conflicting parameters
           content:
@@ -308,6 +311,9 @@ paths:
                     message: Check whether your input value is correct; timezone = NotATimezone
                     error: error
                     path: /v1.0/weather/forecast
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -930,6 +936,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/whois/asn-lookup.yaml

@@ -169,6 +169,9 @@ paths:
                         - zsu@nisc.sri.com
                       abuseContacts: []
                     legacyRoutes: []
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Invalid asn parameter
           content:
@@ -184,6 +187,9 @@ paths:
                     error: Input parameter is not valid
                     message: Request-param 'asn' (ABC123) is not valid
                     path: /v2.0/asn-whois
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not Found — ASN could not be found
           content:
@@ -199,6 +205,9 @@ paths:
                     error: Data Not Found
                     message: ASN data for 999999999 could not be found.
                     path: /v2.0/asn-whois
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -613,6 +622,11 @@ components:
           description: Abuse-reporting contact email addresses for the ASN.
           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/whois/bulk-whois-lookup.yaml

@@ -278,6 +278,9 @@ paths:
 
                             The Registry database contains ONLY .COM, .NET, .EDU domains and
                             Registrars.
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '206':
           description: Partial Content — At least one domain in the batch returned an error; other domains in the same batch still resolved successfully
           content:
@@ -513,6 +516,9 @@ paths:
 
                             The Registry database contains ONLY .COM, .NET, .EDU domains and
                             Registrars.
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Missing or malformed request body
           content:
@@ -528,6 +534,9 @@ paths:
                     path: /v2.0/domain/whois/live
                     status: 400
                     timestamp: '2026-07-23T09:28:56.641Z'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '413':
           description: Payload Too Large — Request exceeds the 100-domain batch limit
           content:
@@ -543,6 +552,9 @@ paths:
                     path: /v2.0/domain/whois/live
                     status: 413
                     timestamp: '2026-07-23T09:28:57.228Z'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -822,6 +834,11 @@ components:
         domain_registrar:
           $ref: '#/components/schemas/DomainRegistrar'
           description: Registrar of record as recorded directly by the registry.
+  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/whois/domain-whois-history-lookup.yaml

@@ -159,6 +159,9 @@ paths:
 
                             The Registry database contains ONLY .COM, .NET, .EDU domains and
                             Registrars.
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Invalid domainName parameter
           content:
@@ -174,6 +177,9 @@ paths:
                     error: Invalid Param Exception
                     message: 'Please pass domain param correct value [For Technical Support: support@whoisfreaks.com]'
                     path: /v1.0/whois
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '404':
           description: Not Found — No historical WHOIS records for the domain
           content:
@@ -189,6 +195,9 @@ paths:
                     error: Record Not Found
                     message: Record not found
                     path: /v1.0/whois
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -440,6 +449,11 @@ components:
         domain_registrar:
           $ref: '#/components/schemas/DomainRegistrar'
           description: Registrar of record as recorded directly by the registry.
+  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/whois/reverse-whois.yaml

@@ -149,6 +149,13 @@ paths:
                         name: On behalf of ipgeolocationdatabase.com OWNER
                         email: 720ed14de67db24c4eb07295ecae369f9f1bfe8a4dd5cd0c51f0e4754ee24895@ipgeolocationdatabase.com.whoisproxy.org
                         company_name: c/o whoisproxy.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'
         '400':
           description: Bad Request -- Missing or invalid search parameters
           content:
@@ -164,6 +171,13 @@ paths:
                     error: Invalid Param Exception
                     message: Please pass param value.
                     path: /v1.0/domain/whois/reverse
+          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 -- No domains match the search criteria
           content:
@@ -179,6 +193,13 @@ paths:
                     error: Record not found
                     message: Record not found.
                     path: /v1.0/domain/whois/reverse
+          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:
@@ -561,6 +582,19 @@ components:
             - string
             - 'null'
           description: Raw WHOIS output from the registry server.
+  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/whois/whois-domain-lookup.yaml

@@ -251,6 +251,9 @@ paths:
                     query_time: '2026-07-23 08:03:00'
                     whois_server: https://tld-rdap.verisign.com/xn--tckwe/v1/
                     domain_registered: 'no'
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '206':
           description: Partial Content — The response contains partial data because an error occurred while processing the request
           content:
@@ -266,6 +269,9 @@ paths:
                     error: Partial Content
                     message: The response contains partial data due to an error while processing the request.
                     path: /v2.0/domain/whois/live
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '400':
           description: Bad Request — Missing or invalid domainName parameter
           content:
@@ -289,6 +295,9 @@ paths:
                     error: Invalid Param Exception
                     message: 'Please pass domain param correct value [For Technical Support: support@whoisfreaks.com]'
                     path: /v2.0/whois/live
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
         '403':
           description: Forbidden — Domain extension not supported for live WHOIS
           content:
@@ -304,6 +313,9 @@ paths:
                     error: Not Supported Domain extension
                     message: We are not providing the whois of this domain extension (local)
                     path: /v2.0/whois/live
+          headers:
+            X-AF-Credits-Cost:
+              $ref: '#/components/headers/X-AF-Credits-Cost'
 components:
   securitySchemes:
     ApiKeyAuthHeader:
@@ -532,6 +544,11 @@ components:
         domain_registrar:
           $ref: '#/components/schemas/DomainRegistrar'
           description: Registrar of record as recorded directly by the registry.
+  headers:
+    X-AF-Credits-Cost:
+      description: Specifies the number of credits consumed by the current request.
+      schema:
+        type: integer
 security:
   - ApiKeyAuthHeader: []
   - ApiKeyAuthQuery: []