@apifreaks/openapi-specs 0.3.0 → 0.3.2

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.
@@ -77,6 +77,10 @@ paths:
           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:
@@ -95,6 +99,23 @@ paths:
           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:
@@ -112,6 +133,23 @@ paths:
           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:
@@ -147,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:
@@ -184,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.
@@ -241,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
@@ -367,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:
@@ -415,6 +454,14 @@ components:
       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,26 @@ 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'
@@ -162,10 +182,10 @@ 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:
@@ -174,6 +194,27 @@ paths:
               $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:
@@ -260,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.
@@ -317,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

package/dist/specs/pdf/{bulk-pdf-generator.yaml → pdf-generator-bulk.yaml}

@@ -158,8 +158,8 @@ components:
     ApiKeyAuthHeader:
       type: apiKey
       in: header
-      name: X-apikey
-      description: Pass your API key via the X-apikey request header.
+      name: X-apiKey
+      description: Pass your API key via the X-apiKey request header.
     ApiKeyAuthQuery:
       type: apiKey
       in: query

package/dist/specs/pdf/pdf-generator.yaml

@@ -285,8 +285,8 @@ components:
     ApiKeyAuthHeader:
       type: apiKey
       in: header
-      name: X-apikey
-      description: Pass your API key via the X-apikey request header.
+      name: X-apiKey
+      description: Pass your API key via the X-apiKey request header.
     ApiKeyAuthQuery:
       type: apiKey
       in: query

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apifreaks/openapi-specs",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Public OpenAPI 3.1 specifications for all APIFreaks API products.",
   "type": "module",
   "main": "./dist/index.js",

package/specs/README.md

@@ -0,0 +1,259 @@
+# APIFreaks OpenAPI specifications
+
+OpenAPI 3.1 documents for [APIFreaks](https://apifreaks.com) API products. Each file is a complete, standalone spec: paths, parameters, request/response schemas, examples, and authentication.
+
+This folder is the source of truth. JSON only. YAML is produced when the npm package is built, not checked in here.
+
+To install the specs as a package (`getSpec`, `SpecSlug`, JSON imports), see the [repository README](../README.md).
+
+## Open a spec
+
+Pick a file, then open it in any OpenAPI-aware tool.
+
+**Swagger Editor:** import this raw GitHub URL (or swap in another path):
+
+```
+https://raw.githubusercontent.com/api-freaks/af-openapi-specs/main/specs/ip-intelligence/ip-locator.json
+```
+
+**Postman / Insomnia:** import the JSON file as an OpenAPI definition.
+
+**Code generation:** point `openapi-generator`, `orval`, `openapi-typescript`, or similar at the same URL:
+
+```bash
+npx openapi-typescript https://raw.githubusercontent.com/api-freaks/af-openapi-specs/main/specs/ip-intelligence/ip-locator.json -o ip-locator.ts
+```
+
+The slug is the filename without `.json`. It is the identifier the npm package uses (`getSpec("ip-locator")`).
+
+## Authentication
+
+Every spec uses an API key from [apifreaks.com](https://apifreaks.com). Either form is valid:
+
+| Location | Name       | Example              |
+| -------- | ---------- | -------------------- |
+| Header   | `X-apiKey` | `X-apiKey: YOUR_KEY` |
+| Query    | `apiKey`   | `?apiKey=YOUR_KEY`   |
+
+Successful responses include `X-AF-Credits-Cost`, the credits consumed by that request. Remaining balances: [usage-credits.json](billing/usage-credits.json).
+
+## Servers
+
+Each document declares its base URL under `servers`. Most products use `https://api.apifreaks.com/v1.0`.
+
+These use `https://api.apifreaks.com/v2.0`: IP geolocation, bulk IP geolocation, timezone lookup, domain WHOIS, bulk WHOIS, and astronomy.
+
+Weather products (except astronomy) use `https://api.apifreaks.com/v1.0/weather`.
+
+## Catalog
+
+Grouped by folder. Slug is the stable id; the name links to the file.
+
+### IP intelligence
+
+| Slug                          | Spec                                                                            |
+| ----------------------------- | ------------------------------------------------------------------------------- |
+| `ip-locator`                  | [IP Geolocation](ip-intelligence/ip-locator.json)                               |
+| `bulk-ip-lookup`              | [Bulk IP Geolocation](ip-intelligence/bulk-ip-lookup.json)                      |
+| `ip-threat-intelligence`      | [IP Threat Intelligence](ip-intelligence/ip-threat-intelligence.json)           |
+| `bulk-ip-threat-intelligence` | [Bulk IP Threat Intelligence](ip-intelligence/bulk-ip-threat-intelligence.json) |
+
+### Geocoding
+
+| Slug                | Spec                                                  |
+| ------------------- | ----------------------------------------------------- |
+| `forward-geocoding` | [Forward Geocoding](geocoding/forward-geocoding.json) |
+| `reverse-geocoding` | [Reverse Geocoding](geocoding/reverse-geocoding.json) |
+
+### WHOIS
+
+| Slug                          | Spec                                                    |
+| ----------------------------- | ------------------------------------------------------- |
+| `whois-domain-lookup`         | [Domain WHOIS](whois/whois-domain-lookup.json)          |
+| `whois-ip-lookup`             | [IP WHOIS](whois/whois-ip-lookup.json)                  |
+| `asn-lookup`                  | [ASN Lookup](whois/asn-lookup.json)                     |
+| `domain-whois-history-lookup` | [WHOIS History](whois/domain-whois-history-lookup.json) |
+| `reverse-whois`               | [Reverse WHOIS](whois/reverse-whois.json)               |
+| `bulk-whois-lookup`           | [Bulk WHOIS](whois/bulk-whois-lookup.json)              |
+
+### DNS
+
+| Slug                 | Spec                                              |
+| -------------------- | ------------------------------------------------- |
+| `dns-lookup`         | [DNS Lookup](dns/dns-lookup.json)                 |
+| `dns-history-lookup` | [DNS History](dns/dns-history-lookup.json)        |
+| `reverse-dns-lookup` | [Reverse DNS Lookup](dns/reverse-dns-lookup.json) |
+| `bulk-dns-lookup`    | [Bulk DNS Lookup](dns/bulk-dns-lookup.json)       |
+
+### Scraper
+
+| Slug          | Spec                                    |
+| ------------- | --------------------------------------- |
+| `web-scraper` | [Web Scraper](scraper/web-scraper.json) |
+
+### Email validation
+
+| Slug                    | Spec                                                                 |
+| ----------------------- | -------------------------------------------------------------------- |
+| `email-checker`         | [Email Checker](email-validation/email-checker.json)                 |
+| `bulk-email-validation` | [Bulk Email Validation](email-validation/bulk-email-validation.json) |
+
+### Phone validation
+
+| Slug                           | Spec                                                                               |
+| ------------------------------ | ---------------------------------------------------------------------------------- |
+| `phone-validation`             | [Phone Validation](phone-number-validation/phone-validation.json)                  |
+| `bulk-phone-number-validation` | [Bulk Phone Validation](phone-number-validation/bulk-phone-number-validation.json) |
+
+### SSL
+
+| Slug                           | Spec                                                                  |
+| ------------------------------ | --------------------------------------------------------------------- |
+| `ssl-certificate-lookup`       | [SSL Certificate Lookup](ssl/ssl-certificate-lookup.json)             |
+| `ssl-certificate-chain-lookup` | [SSL Certificate Chain Lookup](ssl/ssl-certificate-chain-lookup.json) |
+
+### Domain
+
+| Slug                             | Spec                                                                         |
+| -------------------------------- | ---------------------------------------------------------------------------- |
+| `domain-search`                  | [Domain Availability](domain/domain-search.json)                             |
+| `domain-search-with-suggestions` | [Domain Search with Suggestions](domain/domain-search-with-suggestions.json) |
+| `subdomain-lookup`               | [Subdomain Finder](domain/subdomain-lookup.json)                             |
+| `bulk-domain-checker`            | [Bulk Domain Checker](domain/bulk-domain-checker.json)                       |
+
+### Screenshot
+
+| Slug                 | Spec                                                     |
+| -------------------- | -------------------------------------------------------- |
+| `website-screenshot` | [Website Screenshot](screenshot/website-screenshot.json) |
+| `bulk-screenshot`    | [Bulk Screenshot](screenshot/bulk-screenshot.json)       |
+
+### PDF
+
+| Slug                         | Spec                                                          |
+| ---------------------------- | ------------------------------------------------------------- |
+| `merge-pdf`                  | [Merge](pdf/merge-pdf.json)                                   |
+| `split-pdf`                  | [Split](pdf/split-pdf.json)                                   |
+| `pdf-extract-pages`          | [Extract Pages](pdf/pdf-extract-pages.json)                   |
+| `delete-pdf-page`            | [Remove Pages](pdf/delete-pdf-page.json)                      |
+| `pdf-to-image`               | [Convert to Image](pdf/pdf-to-image.json)                     |
+| `pdf-generator`              | [Generate from Template](pdf/pdf-generator.json)              |
+| `pdf-generator-bulk`         | [Bulk Generate from CSV](pdf/pdf-generator-bulk.json)         |
+| `pdf-compress`               | [Compress](pdf/pdf-compress.json)                             |
+| `rotate-pdf-pages`           | [Rotate](pdf/rotate-pdf-pages.json)                           |
+| `pdf-encrypt`                | [Encrypt](pdf/pdf-encrypt.json)                               |
+| `pdf-restrict`               | [Restrict](pdf/pdf-restrict.json)                             |
+| `pdf-decrypt`                | [Decrypt](pdf/pdf-decrypt.json)                               |
+| `pdf-unrestrict`             | [Unrestrict](pdf/pdf-unrestrict.json)                         |
+| `linearize-pdf`              | [Linearize](pdf/linearize-pdf.json)                           |
+| `pdf-task-status`            | [Task Status](pdf/pdf-task-status.json)                       |
+| `pdf-file-status`            | [File Status](pdf/pdf-file-status.json)                       |
+| `pdf-files`                  | [List Files](pdf/pdf-files.json)                              |
+| `pdf-file`                   | [Delete File](pdf/pdf-file.json)                              |
+| `pdf-resource-upload`        | [Upload Resource](pdf/pdf-resource-upload.json)               |
+| `pdf-resource-upload-binary` | [Upload Binary Resource](pdf/pdf-resource-upload-binary.json) |
+| `pdf-resource-download`      | [Download Resource](pdf/pdf-resource-download.json)           |
+
+### Currency
+
+| Slug                               | Spec                                                                         |
+| ---------------------------------- | ---------------------------------------------------------------------------- |
+| `currency-rate`                    | [Exchange Rates](currency/currency-rate.json)                                |
+| `historical-currency-rate`         | [Historical Exchange Rates](currency/historical-currency-rate.json)          |
+| `currency-converter`               | [Currency Converter](currency/currency-converter.json)                       |
+| `historical-currency-converter`    | [Historical Currency Converter](currency/historical-currency-converter.json) |
+| `currency-time-series`             | [Currency Time Series](currency/currency-time-series.json)                   |
+| `currency-fluctuation`             | [Currency Fluctuation](currency/currency-fluctuation.json)                   |
+| `geolocalized-currency-conversion` | [IP-to-Currency Conversion](currency/geolocalized-currency-conversion.json)  |
+| `currency-supported`               | [Supported Currencies](currency/currency-supported.json)                     |
+| `currency-symbols`                 | [Currency Symbols](currency/currency-symbols.json)                           |
+| `currency-historical-data-limit`   | [Historical Data Limits](currency/currency-historical-data-limit.json)       |
+
+### Commodity
+
+| Slug                          | Spec                                                                      |
+| ----------------------------- | ------------------------------------------------------------------------- |
+| `commodity-prices`            | [Live Commodity Prices](commodity/commodity-prices.json)                  |
+| `historical-commodity-prices` | [Historical Commodity Prices](commodity/historical-commodity-prices.json) |
+| `commodity-fluctuation`       | [Commodity Fluctuation](commodity/commodity-fluctuation.json)             |
+| `commodity-time-series`       | [Commodity Time Series](commodity/commodity-time-series.json)             |
+| `commodity-symbols`           | [Commodity Symbols](commodity/commodity-symbols.json)                     |
+
+### Financial
+
+| Slug                                 | Spec                                                                     |
+| ------------------------------------ | ------------------------------------------------------------------------ |
+| `vat-rates-country`                  | [VAT Rates by Country](financial/vat-rates-country.json)                 |
+| `bulk-vat-rates-country`             | [Bulk VAT Rates by Country](financial/bulk-vat-rates-country.json)       |
+| `vat-rates-by-ip`                    | [VAT Rates by IP](financial/vat-rates-by-ip.json)                        |
+| `vat-number-validation`              | [VAT Number Validation](financial/vat-number-validation.json)            |
+| `iban-validation`                    | [IBAN Validation](financial/iban-validation.json)                        |
+| `swift-code-lookup`                  | [SWIFT/BIC Lookup](financial/swift-code-lookup.json)                     |
+| `swift-code-finder`                  | [SWIFT/BIC Finder](financial/swift-code-finder.json)                     |
+| `financial-apis-supported-countries` | [Supported Countries](financial/financial-apis-supported-countries.json) |
+
+### ZIP code
+
+| Slug                      | Spec                                                        |
+| ------------------------- | ----------------------------------------------------------- |
+| `zip-code-api`            | [ZIP / Postal Code Lookup](zip-code/zip-code-api.json)      |
+| `zip-codes-radius-search` | [ZIP Radius Search](zip-code/zip-codes-radius-search.json)  |
+| `zip-code-distance`       | [ZIP Distance](zip-code/zip-code-distance.json)             |
+| `zip-codes-by-city`       | [ZIP Codes by City](zip-code/zip-codes-by-city.json)        |
+| `bulk-zip-code-lookup`    | [Bulk ZIP Lookup](zip-code/bulk-zip-code-lookup.json)       |
+| `zip-code-distance-match` | [ZIP Distance Match](zip-code/zip-code-distance-match.json) |
+| `zip-codes-by-region`     | [ZIP Codes by Region](zip-code/zip-codes-by-region.json)    |
+
+### Weather
+
+| Slug                  | Spec                                                    |
+| --------------------- | ------------------------------------------------------- |
+| `live-weather`        | [Live Weather](weather/live-weather.json)               |
+| `weather-forecast`    | [Weather Forecast](weather/weather-forecast.json)       |
+| `historical-weather`  | [Historical Weather](weather/historical-weather.json)   |
+| `time-series-weather` | [Time Series Weather](weather/time-series-weather.json) |
+| `air-quality`         | [Air Quality](weather/air-quality.json)                 |
+| `marine-weather`      | [Marine Weather](weather/marine-weather.json)           |
+| `flood-forecast`      | [Flood Forecast](weather/flood-forecast.json)           |
+| `bulk-live-weather`   | [Bulk Live Weather](weather/bulk-live-weather.json)     |
+| `astronomy-data`      | [Astronomy](weather/astronomy-data.json)                |
+
+### Geography
+
+| Slug                           | Spec                                                              |
+| ------------------------------ | ----------------------------------------------------------------- |
+| `administrative-units-levels`  | [Admin Levels](geography/administrative-units-levels.json)        |
+| `administrative-units`         | [Administrative Units](geography/administrative-units.json)       |
+| `administrative-units-details` | [Admin Unit Details](geography/administrative-units-details.json) |
+| `countries`                    | [Countries](geography/countries.json)                             |
+| `countries-details`            | [Country Details](geography/countries-details.json)               |
+| `cities`                       | [Cities](geography/cities.json)                                   |
+| `regions`                      | [Regions](geography/regions.json)                                 |
+| `subregions`                   | [Subregions](geography/subregions.json)                           |
+| `flags-supported`              | [Supported Flags](geography/flags-supported.json)                 |
+| `flags`                        | [Flags](geography/flags.json)                                     |
+
+### Timezone
+
+| Slug                 | Spec                                                   |
+| -------------------- | ------------------------------------------------------ |
+| `timezone-lookup`    | [Timezone Lookup](timezone/timezone-lookup.json)       |
+| `timezone-converter` | [Timezone Converter](timezone/timezone-converter.json) |
+
+### User agent
+
+| Slug                     | Spec                                                             |
+| ------------------------ | ---------------------------------------------------------------- |
+| `user-agent-parser`      | [User Agent Parser](user-agent/user-agent-parser.json)           |
+| `bulk-user-agent-parser` | [Bulk User Agent Parser](user-agent/bulk-user-agent-parser.json) |
+
+### Billing
+
+| Slug            | Spec                                        |
+| --------------- | ------------------------------------------- |
+| `usage-credits` | [Credits Usage](billing/usage-credits.json) |
+
+## Docs and support
+
+- Product docs: [apifreaks.com](https://apifreaks.com)
+- Contact: [apifreaks.com/contact](https://apifreaks.com/contact) · support@apifreaks.com