diff --git a/apifreaks.yaml b/apifreaks.yaml new file mode 100644 index 0000000..ef32359 --- /dev/null +++ b/apifreaks.yaml @@ -0,0 +1,12197 @@ +openapi: 3.0.3 +info: + title: APIFreaks Threat Intelligence & Geo APIs + description: 'APIFreaks endpoints for security enrichment and geospatial lookups: IP intelligence, WHOIS, + DNS, SSL, domain, geocoding, GeoDB, timezone, user-agent parsing, and astronomy. Authenticate with + your API key in the X-apiKey header. Get a free key at https://apifreaks.com/signup.' + version: 1.0.0 + contact: + name: APIFreaks + url: https://apifreaks.com +servers: +- url: https://api.apifreaks.com + description: Base server +security: +- ApiKeyAuth: [] +tags: +- name: IP Geolocation +- name: Geocoding +- name: WHOIS +- name: DNS +- name: SSL +- name: Domain +- name: GeoDB +- name: Timezone +- name: User Agent +- name: Astronomy +paths: + /v1.0/domain/dns/live: + get: + tags: + - DNS + summary: Get A, AAAA, MX, NS, SOA, SPF, TXT, and CNAME DNS records for any hostname + description: 'Retrieve real-time DNS records for any hostname. Supports multiple record types including + A, AAAA, MX, NS, SOA, SPF, TXT, and CNAME records. + + ' + operationId: dnsLookup + security: + - ApiKeyAuth: [] + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - name: host-name + in: query + required: false + schema: + type: string + description: Hostname or URL whose DNS records are required. + - name: ipAddress + in: query + required: false + schema: + type: string + description: The IP address for requested DNS's PTR record. 'type' parameter must be set to 'all'. + - name: type + in: query + required: true + schema: + type: string + description: 'A comma-separated list of DNS record types for lookup. Possible values: A, AAAA, + MX, NS, SOA, SPF, TXT, CNAME, or all. When ipAddress is provided, type must be "all".' + responses: + '200': + description: Successful DNS lookup response + content: + application/json: + schema: + $ref: '#/components/schemas/DnsDNSLookupResponse' + example: + status: true + queryTime: '2026-06-06 10:43:05' + domainName: example.com + domainRegistered: true + dnsTypes: + A: 1 + NS: 2 + SOA: 6 + MX: 15 + TXT: 16 + AAAA: 28 + SPF: 99 + dnsRecords: + - name: example.com + type: 1 + dnsType: A + ttl: 300 + rawText: "example.com.\t\t300\tIN\tA\t104.20.23.154" + rRsetType: 1 + address: 104.20.23.154 + - name: example.com + type: 1 + dnsType: A + ttl: 300 + rawText: "example.com.\t\t300\tIN\tA\t172.66.147.243" + rRsetType: 1 + address: 172.66.147.243 + - name: example.com + type: 2 + dnsType: NS + ttl: 21600 + rawText: "example.com.\t\t21600\tIN\tNS\telliott.ns.cloudflare.com." + rRsetType: 2 + singleName: elliott.ns.cloudflare.com. + - name: example.com + type: 2 + dnsType: NS + ttl: 21600 + rawText: "example.com.\t\t21600\tIN\tNS\thera.ns.cloudflare.com." + rRsetType: 2 + singleName: hera.ns.cloudflare.com. + - name: example.com + type: 6 + dnsType: SOA + ttl: 1800 + rawText: "example.com.\t\t1800\tIN\tSOA\telliott.ns.cloudflare.com. dns.cloudflare.com.\ + \ 2405749864 10000 2400 604800 1800" + rRsetType: 6 + admin: dns.cloudflare.com. + host: elliott.ns.cloudflare.com. + expire: 604800 + minimum: 1800 + refresh: 10000 + retry: 2400 + serial: 2405749864 + - name: example.com + type: 15 + dnsType: MX + ttl: 236 + rawText: "example.com.\t\t236\tIN\tMX\t0 ." + rRsetType: 15 + target: . + priority: 0 + - name: example.com + type: 16 + dnsType: TXT + ttl: 300 + rawText: "example.com.\t\t300\tIN\tTXT\t\"_k2n1y4vw3qtb4skdx9e7dxt97qrmmq9\"" + rRsetType: 16 + strings: + - _k2n1y4vw3qtb4skdx9e7dxt97qrmmq9 + - name: example.com + type: 28 + dnsType: AAAA + ttl: 300 + rawText: "example.com.\t\t300\tIN\tAAAA\t2606:4700:10:0:0:0:ac42:93f3" + rRsetType: 28 + address: 2606:4700:10:0:0:0:ac42:93f3 + - name: example.com + type: 28 + dnsType: AAAA + ttl: 300 + rawText: "example.com.\t\t300\tIN\tAAAA\t2606:4700:10:0:0:0:6814:179a" + rRsetType: 28 + address: 2606:4700:10:0:0:0:6814:179a + - name: example.com + type: 99 + dnsType: SPF + ttl: 300 + rawText: "example.com.\t\t300\tIN\tSPF\t\"v=spf1 -all\"" + rRsetType: 99 + strings: + - v=spf1 -all + '400': + description: Invalid DNS type + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:09:36.260Z' + path: /v1.0/domain/dns/live + status: 400 + error: Invalid DNS Type Exception + message: please pass correct parameters + '404': + description: Domain not found + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:09:36.260Z' + path: /v1.0/domain/dns/live + status: 404 + error: Not Found Exception + message: 'Entered Domain does not exist: ' + '408': + description: Request Timeout + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:09:36.260Z' + path: /v1.0/domain/dns/live + status: 408 + error: Request Timeout + message: 'Unable to fetch dns records. Please try after some time. [For Technical Support + email at: support@whoisfreaks.com]' + '503': + description: Service Unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:09:36.260Z' + path: /v1.0/domain/dns/live + status: 503 + error: Service Unavailable + message: Service is unavailable. + '504': + description: Gateway Timeout + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:09:36.260Z' + path: /v1.0/domain/dns/live + status: 504 + error: Gateway Timeout + message: Request is timed-out. + post: + tags: + - DNS + summary: Retrieve A, AAAA, MX, NS, SOA, SPF, TXT, and CNAME DNS records of multiple hostnames in + a single request + description: 'Perform DNS lookups for multiple hostnames in a single request. Supports up to `100 + host-names per request` + + and returns DNS records including A, AAAA, MX, NS, SOA, SPF, TXT, and CNAME records. + + ' + operationId: bulkDnsLookup + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - domainNames + properties: + domainNames: + type: array + description: List of hostnames to lookup DNS records for + maxItems: 100 + items: + type: string + ipAddresses: + type: array + description: Array of IP addresses to include in the lookup for enrichment + items: + type: string + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - name: type + in: query + required: true + schema: + type: string + description: 'A comma-separated list of DNS record types for lookup. + + Possible values: A, AAAA, MX, NS, SOA, SPF, TXT, CNAME, or all + + ' + responses: + '200': + description: Successful DNS lookup response + content: + application/json: + schema: + $ref: '#/components/schemas/DnsBulkDNSLookupResponse' + example: + bulk_dns_info: + - status: true + queryTime: '2026-06-17 09:43:40' + ipAddress: 8.8.8.8 + dnsTypes: + PTR: 12 + dnsRecords: + - name: 8.8.8.8.in-addr.arpa + type: 12 + dnsType: PTR + ttl: 3933 + rawText: "8.8.8.8.in-addr.arpa.\t3933\tIN\tPTR\tdns.google." + rRsetType: 12 + singleName: dns.google. + - status: true + queryTime: '2026-06-17 09:43:40' + domainName: google.com + domainRegistered: true + dnsTypes: + A: 1 + NS: 2 + SOA: 6 + MX: 15 + TXT: 16 + AAAA: 28 + SPF: 99 + dnsRecords: + - name: google.com + type: 1 + dnsType: A + ttl: 266 + rawText: "google.com.\t\t266\tIN\tA\t142.250.27.113" + rRsetType: 1 + address: 142.250.27.113 + - name: google.com + type: 1 + dnsType: A + ttl: 266 + rawText: "google.com.\t\t266\tIN\tA\t142.250.27.100" + rRsetType: 1 + address: 142.250.27.100 + - name: google.com + type: 1 + dnsType: A + ttl: 266 + rawText: "google.com.\t\t266\tIN\tA\t142.250.27.101" + rRsetType: 1 + address: 142.250.27.101 + - name: google.com + type: 1 + dnsType: A + ttl: 266 + rawText: "google.com.\t\t266\tIN\tA\t142.250.27.102" + rRsetType: 1 + address: 142.250.27.102 + - name: google.com + type: 1 + dnsType: A + ttl: 266 + rawText: "google.com.\t\t266\tIN\tA\t142.250.27.138" + rRsetType: 1 + address: 142.250.27.138 + - name: google.com + type: 1 + dnsType: A + ttl: 266 + rawText: "google.com.\t\t266\tIN\tA\t142.250.27.139" + rRsetType: 1 + address: 142.250.27.139 + - name: google.com + type: 2 + dnsType: NS + ttl: 21600 + rawText: "google.com.\t\t21600\tIN\tNS\tns3.google.com." + rRsetType: 2 + singleName: ns3.google.com. + - name: google.com + type: 2 + dnsType: NS + ttl: 21600 + rawText: "google.com.\t\t21600\tIN\tNS\tns4.google.com." + rRsetType: 2 + singleName: ns4.google.com. + - name: google.com + type: 2 + dnsType: NS + ttl: 21600 + rawText: "google.com.\t\t21600\tIN\tNS\tns2.google.com." + rRsetType: 2 + singleName: ns2.google.com. + - name: google.com + type: 2 + dnsType: NS + ttl: 21600 + rawText: "google.com.\t\t21600\tIN\tNS\tns1.google.com." + rRsetType: 2 + singleName: ns1.google.com. + - name: google.com + type: 6 + dnsType: SOA + ttl: 20 + rawText: "google.com.\t\t20\tIN\tSOA\tns1.google.com. dns-admin.google.com. 932992649\ + \ 900 900 1800 60" + rRsetType: 6 + admin: dns-admin.google.com. + host: ns1.google.com. + expire: 1800 + minimum: 60 + refresh: 900 + retry: 900 + serial: 932992649 + - name: google.com + type: 15 + dnsType: MX + ttl: 198 + rawText: "google.com.\t\t198\tIN\tMX\t10 smtp.google.com." + rRsetType: 15 + target: smtp.google.com. + priority: 10 + - name: google.com + type: 16 + dnsType: TXT + ttl: 300 + rawText: "google.com.\t\t300\tIN\tTXT\t\"onetrust-domain-verification=6d685f1d41a94696ad7ef771f68993e0\"" + rRsetType: 16 + strings: + - onetrust-domain-verification=6d685f1d41a94696ad7ef771f68993e0 + - name: google.com + type: 16 + dnsType: TXT + ttl: 300 + rawText: "google.com.\t\t300\tIN\tTXT\t\"google-site-verification=TV9-DBe4R80X4v0M4U_bd_J9cpOJM0nikft0jAgjmsQ\"" + rRsetType: 16 + strings: + - google-site-verification=TV9-DBe4R80X4v0M4U_bd_J9cpOJM0nikft0jAgjmsQ + - name: google.com + type: 16 + dnsType: TXT + ttl: 300 + rawText: "google.com.\t\t300\tIN\tTXT\t\"onetrust-domain-verification=0d477fe608074e6f9c12bca7826035cc\"" + rRsetType: 16 + strings: + - onetrust-domain-verification=0d477fe608074e6f9c12bca7826035cc + - name: google.com + type: 16 + dnsType: TXT + ttl: 300 + rawText: "google.com.\t\t300\tIN\tTXT\t\"MS=E4A68B9AB2BB9670BCE15412F62916164C0B20BB\"" + rRsetType: 16 + strings: + - MS=E4A68B9AB2BB9670BCE15412F62916164C0B20BB + - name: google.com + type: 16 + dnsType: TXT + ttl: 300 + rawText: "google.com.\t\t300\tIN\tTXT\t\"docusign=05958488-4752-4ef2-95eb-aa7ba8a3bd0e\"" + rRsetType: 16 + strings: + - docusign=05958488-4752-4ef2-95eb-aa7ba8a3bd0e + - name: google.com + type: 16 + dnsType: TXT + ttl: 300 + rawText: "google.com.\t\t300\tIN\tTXT\t\"google-site-verification=4ibFUgB-wXLQ_S7vsXVomSTVamuOXBiVAzpR5IZ87D0\"" + rRsetType: 16 + strings: + - google-site-verification=4ibFUgB-wXLQ_S7vsXVomSTVamuOXBiVAzpR5IZ87D0 + - name: google.com + type: 16 + dnsType: TXT + ttl: 300 + rawText: "google.com.\t\t300\tIN\tTXT\t\"cisco-ci-domain-verification=47c38bc8c4b74b7233e9053220c1bbe76bcc1cd33c7acf7acd36cd6a5332004b\"" + rRsetType: 16 + strings: + - cisco-ci-domain-verification=47c38bc8c4b74b7233e9053220c1bbe76bcc1cd33c7acf7acd36cd6a5332004b + - name: google.com + type: 16 + dnsType: TXT + ttl: 300 + rawText: "google.com.\t\t300\tIN\tTXT\t\"facebook-domain-verification=22rm551cu4k0ab0bxsw536tlds4h95\"" + rRsetType: 16 + strings: + - facebook-domain-verification=22rm551cu4k0ab0bxsw536tlds4h95 + - name: google.com + type: 16 + dnsType: TXT + ttl: 300 + rawText: "google.com.\t\t300\tIN\tTXT\t\"docusign=1b0a6754-49b1-4db5-8540-d2c12664b289\"" + rRsetType: 16 + strings: + - docusign=1b0a6754-49b1-4db5-8540-d2c12664b289 + - name: google.com + type: 16 + dnsType: TXT + ttl: 300 + rawText: "google.com.\t\t300\tIN\tTXT\t\"apple-domain-verification=30afIBcvSuDV2PLX\"" + rRsetType: 16 + strings: + - apple-domain-verification=30afIBcvSuDV2PLX + - name: google.com + type: 16 + dnsType: TXT + ttl: 300 + rawText: "google.com.\t\t300\tIN\tTXT\t\"globalsign-smime-dv=CDYX+XFHUw2wml6/Gb8+59BsH31KzUr6c1l2BPvqKX8=\"" + rRsetType: 16 + strings: + - globalsign-smime-dv=CDYX+XFHUw2wml6/Gb8+59BsH31KzUr6c1l2BPvqKX8= + - name: google.com + type: 16 + dnsType: TXT + ttl: 300 + rawText: "google.com.\t\t300\tIN\tTXT\t\"google-site-verification=wD8N7i1JTNTkezJ49swvWW48f8_9xveREV4oB-0Hf5o\"" + rRsetType: 16 + strings: + - google-site-verification=wD8N7i1JTNTkezJ49swvWW48f8_9xveREV4oB-0Hf5o + - name: google.com + type: 28 + dnsType: AAAA + ttl: 106 + rawText: "google.com.\t\t106\tIN\tAAAA\t2a00:1450:4025:401:0:0:0:8b" + rRsetType: 28 + address: 2a00:1450:4025:401:0:0:0:8b + - name: google.com + type: 28 + dnsType: AAAA + ttl: 106 + rawText: "google.com.\t\t106\tIN\tAAAA\t2a00:1450:4025:401:0:0:0:71" + rRsetType: 28 + address: 2a00:1450:4025:401:0:0:0:71 + - name: google.com + type: 28 + dnsType: AAAA + ttl: 106 + rawText: "google.com.\t\t106\tIN\tAAAA\t2a00:1450:4025:401:0:0:0:64" + rRsetType: 28 + address: 2a00:1450:4025:401:0:0:0:64 + - name: google.com + type: 28 + dnsType: AAAA + ttl: 106 + rawText: "google.com.\t\t106\tIN\tAAAA\t2a00:1450:4025:401:0:0:0:66" + rRsetType: 28 + address: 2a00:1450:4025:401:0:0:0:66 + - name: google.com + type: 99 + dnsType: SPF + ttl: 300 + rawText: "google.com.\t\t300\tIN\tSPF\t\"v=spf1 include:_spf.google.com ~all\"" + rRsetType: 99 + strings: + - v=spf1 include:_spf.google.com ~all + - status: true + queryTime: '2026-06-17 09:43:40' + ipAddress: 1.1.1.1 + dnsTypes: + PTR: 12 + dnsRecords: + - name: 1.1.1.1.in-addr.arpa + type: 12 + dnsType: PTR + ttl: 405 + rawText: "1.1.1.1.in-addr.arpa.\t405\tIN\tPTR\tone.one.one.one." + rRsetType: 12 + singleName: one.one.one.one. + - status: true + queryTime: '2026-06-17 09:43:40' + domainName: example.com + domainRegistered: true + dnsTypes: + A: 1 + NS: 2 + SOA: 6 + MX: 15 + TXT: 16 + AAAA: 28 + SPF: 99 + dnsRecords: + - name: example.com + type: 1 + dnsType: A + ttl: 300 + rawText: "example.com.\t\t300\tIN\tA\t104.20.23.154" + rRsetType: 1 + address: 104.20.23.154 + - name: example.com + type: 1 + dnsType: A + ttl: 300 + rawText: "example.com.\t\t300\tIN\tA\t172.66.147.243" + rRsetType: 1 + address: 172.66.147.243 + - name: example.com + type: 2 + dnsType: NS + ttl: 21600 + rawText: "example.com.\t\t21600\tIN\tNS\telliott.ns.cloudflare.com." + rRsetType: 2 + singleName: elliott.ns.cloudflare.com. + - name: example.com + type: 2 + dnsType: NS + ttl: 21600 + rawText: "example.com.\t\t21600\tIN\tNS\thera.ns.cloudflare.com." + rRsetType: 2 + singleName: hera.ns.cloudflare.com. + - name: example.com + type: 6 + dnsType: SOA + ttl: 1800 + rawText: "example.com.\t\t1800\tIN\tSOA\telliott.ns.cloudflare.com. dns.cloudflare.com.\ + \ 2405749864 10000 2400 604800 1800" + rRsetType: 6 + admin: dns.cloudflare.com. + host: elliott.ns.cloudflare.com. + expire: 604800 + minimum: 1800 + refresh: 10000 + retry: 2400 + serial: 2405749864 + - name: example.com + type: 15 + dnsType: MX + ttl: 86 + rawText: "example.com.\t\t86\tIN\tMX\t0 ." + rRsetType: 15 + target: . + priority: 0 + - name: example.com + type: 16 + dnsType: TXT + ttl: 300 + rawText: "example.com.\t\t300\tIN\tTXT\t\"_k2n1y4vw3qtb4skdx9e7dxt97qrmmq9\"" + rRsetType: 16 + strings: + - _k2n1y4vw3qtb4skdx9e7dxt97qrmmq9 + - name: example.com + type: 28 + dnsType: AAAA + ttl: 300 + rawText: "example.com.\t\t300\tIN\tAAAA\t2606:4700:10:0:0:0:ac42:93f3" + rRsetType: 28 + address: 2606:4700:10:0:0:0:ac42:93f3 + - name: example.com + type: 28 + dnsType: AAAA + ttl: 300 + rawText: "example.com.\t\t300\tIN\tAAAA\t2606:4700:10:0:0:0:6814:179a" + rRsetType: 28 + address: 2606:4700:10:0:0:0:6814:179a + - name: example.com + type: 99 + dnsType: SPF + ttl: 300 + rawText: "example.com.\t\t300\tIN\tSPF\t\"v=spf1 -all\"" + rRsetType: 99 + strings: + - v=spf1 -all + '400': + description: Invalid DNS record type + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:09:36.260Z' + path: /v1.0/domain/dns/live + status: 400 + error: Invalid Param Exception + message: please pass correct parameters + '408': + description: Request Timeout + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:09:36.260Z' + path: /v1.0/domain/dns/live + status: 408 + error: Request Timeout + message: 'Unable to fetch dns recIords. Please try again [For Technical Support: support@whoisfreaks.com].' + '503': + description: Service Unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:09:36.260Z' + path: /v1.0/domain/dns/live + status: 503 + error: Service Unavailable + message: Service is unavailable. Please try after some time. + '504': + description: Gateway Timeout + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:09:36.260Z' + path: /v1.0/domain/dns/live + status: 504 + error: Gateway Timeout + message: Request is timed-out + security: + - ApiKeyAuth: [] + /v1.0/domain/dns/history: + get: + tags: + - DNS + summary: Get all historical A, AAAA, MX, NS, SOA, SPF, TXT, and CNAME DNS records of a hostname + description: 'Retrieve historical DNS records for any hostname. Access unique historical data for + A, AAAA, MX, NS, SOA, SPF, TXT, and CNAME records, + + including subdomains. Results are paginated with up to 100 unique records per page. + + ' + operationId: dnsHistoryLookup + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - name: host-name + in: query + required: true + schema: + type: string + description: Hostname or URL whose historical DNS records are required + - name: type + in: query + required: true + schema: + type: string + description: 'A comma-separated list of DNS record types for lookup. + + Possible values: A, AAAA, MX, NS, SOA, SPF, TXT, CNAME, or all + + ' + - name: page + in: query + required: false + schema: + type: integer + minimum: 1 + default: 1 + description: Page number for paginated results + responses: + '200': + description: Successful DNS history lookup response + content: + application/json: + schema: + type: object + properties: + totalPages: + type: integer + currentPage: + type: integer + totalRecords: + type: integer + historicalDnsRecords: + type: array + items: + type: object + required: + - queryTime + - domainName + - dnsTypes + - dnsRecords + properties: + queryTime: + type: string + description: 'Date when the DNS snapshot was taken. (Format: YYYY-MM-DD)' + domainName: + type: string + description: Queried domain name with trailing dot. + dnsTypes: + type: object + properties: + A: + type: number + AAAA: + type: number + MX: + type: number + NS: + type: number + SOA: + type: number + TXT: + type: number + SPF: + type: number + dnsRecords: + type: array + items: + oneOf: + - $ref: '#/components/schemas/DnsAorAAAARecord' + - $ref: '#/components/schemas/DnsCNAMERecord' + - $ref: '#/components/schemas/DnsMXRecord' + - $ref: '#/components/schemas/DnsNSRecord' + - $ref: '#/components/schemas/DnsSOARecord' + - $ref: '#/components/schemas/DnsTXTRecord' + required: + - totalRecords + - totalPages + - currentPage + - historicalDnsRecords + example: + totalRecords: 46 + totalPages: 1 + currentPage: 1 + historicalDnsRecords: + - queryTime: '2025-12-16' + domainName: example.com. + dnsTypes: + SOA: 6 + AAAA: 28 + A: 1 + NS: 2 + dnsRecords: + - name: example.com + type: 1 + dnsType: A + ttl: 4 + rawText: "example.com.\t\t4\tIN\tA\t23.192.228.84" + rRsetType: 1 + address: 23.192.228.84 + - name: example.com + type: 1 + dnsType: A + ttl: 4 + rawText: "example.com.\t\t4\tIN\tA\t23.215.0.136" + rRsetType: 1 + address: 23.215.0.136 + - name: example.com + type: 1 + dnsType: A + ttl: 278 + rawText: "example.com.\t\t278\tIN\tA\t23.220.75.245" + rRsetType: 1 + address: 23.220.75.245 + - name: example.com + type: 1 + dnsType: A + ttl: 278 + rawText: "example.com.\t\t278\tIN\tA\t23.220.75.232" + rRsetType: 1 + address: 23.220.75.232 + - name: example.com + type: 1 + dnsType: A + ttl: 4 + rawText: "example.com.\t\t4\tIN\tA\t23.215.0.138" + rRsetType: 1 + address: 23.215.0.138 + - name: example.com + type: 1 + dnsType: A + ttl: 4 + rawText: "example.com.\t\t4\tIN\tA\t23.192.228.80" + rRsetType: 1 + address: 23.192.228.80 + - name: example.com + type: 28 + dnsType: AAAA + ttl: 89 + rawText: "example.com.\t\t89\tIN\tAAAA\t2600:1406:5e00:6:0:0:17ce:bc12" + rRsetType: 28 + address: 2600:1406:5e00:6:0:0:17ce:bc12 + - name: example.com + type: 28 + dnsType: AAAA + ttl: 202 + rawText: "example.com.\t\t202\tIN\tAAAA\t2600:1406:bc00:53:0:0:b81e:94ce" + rRsetType: 28 + address: 2600:1406:bc00:53:0:0:b81e:94ce + - name: example.com + type: 28 + dnsType: AAAA + ttl: 89 + rawText: "example.com.\t\t89\tIN\tAAAA\t2600:1406:5e00:6:0:0:17ce:bc1b" + rRsetType: 28 + address: 2600:1406:5e00:6:0:0:17ce:bc1b + - name: example.com + type: 28 + dnsType: AAAA + ttl: 202 + rawText: "example.com.\t\t202\tIN\tAAAA\t2600:1408:ec00:36:0:0:1736:7f31" + rRsetType: 28 + address: 2600:1408:ec00:36:0:0:1736:7f31 + - name: example.com + type: 28 + dnsType: AAAA + ttl: 202 + rawText: "example.com.\t\t202\tIN\tAAAA\t2600:1408:ec00:36:0:0:1736:7f24" + rRsetType: 28 + address: 2600:1408:ec00:36:0:0:1736:7f24 + - name: example.com + type: 28 + dnsType: AAAA + ttl: 202 + rawText: "example.com.\t\t202\tIN\tAAAA\t2600:1406:bc00:53:0:0:b81e:94c8" + rRsetType: 28 + address: 2600:1406:bc00:53:0:0:b81e:94c8 + - name: example.com + type: 6 + dnsType: SOA + ttl: 3600 + rawText: "example.com.\t\t3600\tIN\tSOA\tns.icann.org. noc.dns.icann.org. 2022091323\ + \ 7200 3600 1209600 3600" + rRsetType: 6 + admin: noc.dns.icann.org. + host: ns.icann.org. + expire: 1209600 + minimum: 3600 + refresh: 7200 + retry: 3600 + serial: 2022091323 + - name: example.com + type: 2 + dnsType: NS + ttl: 21600 + rawText: "example.com.\t\t21600\tIN\tNS\ta.iana-servers.net." + rRsetType: 2 + singleName: a.iana-servers.net. + - name: example.com + type: 2 + dnsType: NS + ttl: 21600 + rawText: "example.com.\t\t21600\tIN\tNS\tb.iana-servers.net." + rRsetType: 2 + singleName: b.iana-servers.net. + - queryTime: '2025-12-17' + domainName: example.com. + dnsTypes: + AAAA: 28 + A: 1 + NS: 2 + dnsRecords: + - name: example.com + type: 1 + dnsType: A + ttl: 300 + rawText: "example.com.\t\t300\tIN\tA\t104.20.34.220" + rRsetType: 1 + address: 104.20.34.220 + - name: example.com + type: 1 + dnsType: A + ttl: 300 + rawText: "example.com.\t\t300\tIN\tA\t172.66.144.113" + rRsetType: 1 + address: 172.66.144.113 + - name: example.com + type: 28 + dnsType: AAAA + ttl: 300 + rawText: "example.com.\t\t300\tIN\tAAAA\t2606:4700:10:0:0:0:ac42:9071" + rRsetType: 28 + address: 2606:4700:10:0:0:0:ac42:9071 + - name: example.com + type: 28 + dnsType: AAAA + ttl: 300 + rawText: "example.com.\t\t300\tIN\tAAAA\t2606:4700:10:0:0:0:6814:22dc" + rRsetType: 28 + address: 2606:4700:10:0:0:0:6814:22dc + - name: example.com + type: 2 + dnsType: NS + ttl: 128 + rawText: "example.com.\t\t128\tIN\tNS\ta.iana-servers.net." + rRsetType: 2 + singleName: a.iana-servers.net. + - name: example.com + type: 2 + dnsType: NS + ttl: 128 + rawText: "example.com.\t\t128\tIN\tNS\tb.iana-servers.net." + rRsetType: 2 + singleName: b.iana-servers.net. + - queryTime: '2023-12-10' + domainName: example.com. + dnsTypes: + SOA: 6 + dnsRecords: + - name: example.com + type: 6 + dnsType: SOA + ttl: 3600 + rawText: "example.com.\t\t3600\tIN\tSOA\tns.icann.org. noc.dns.icann.org. 2022091325\ + \ 7200 3600 1209600 3600" + rRsetType: 6 + admin: noc.dns.icann.org. + host: ns.icann.org. + expire: 1209600 + minimum: 3600 + refresh: 7200 + retry: 3600 + serial: 2022091325 + - name: example.com + type: 6 + dnsType: SOA + ttl: 3600 + rawText: "example.com.\t\t3600\tIN\tSOA\tns.icann.org. noc.dns.icann.org. 2022091216\ + \ 7200 3600 1209600 3600" + rRsetType: 6 + admin: noc.dns.icann.org. + host: ns.icann.org. + expire: 1209600 + minimum: 3600 + refresh: 7200 + retry: 3600 + serial: 2022091216 + - queryTime: '2025-08-14' + domainName: example.com. + dnsTypes: + AAAA: 28 + A: 1 + dnsRecords: + - name: example.com + type: 1 + dnsType: A + ttl: 4 + rawText: "example.com.\t\t4\tIN\tA\t96.7.128.175" + rRsetType: 1 + address: 96.7.128.175 + - name: example.com + type: 1 + dnsType: A + ttl: 4 + rawText: "example.com.\t\t4\tIN\tA\t96.7.128.198" + rRsetType: 1 + address: 96.7.128.198 + - name: example.com + type: 28 + dnsType: AAAA + ttl: 202 + rawText: "example.com.\t\t202\tIN\tAAAA\t2600:1406:3a00:21:0:0:173e:2e65" + rRsetType: 28 + address: 2600:1406:3a00:21:0:0:173e:2e65 + - name: example.com + type: 28 + dnsType: AAAA + ttl: 202 + rawText: "example.com.\t\t202\tIN\tAAAA\t2600:1406:3a00:21:0:0:173e:2e66" + rRsetType: 28 + address: 2600:1406:3a00:21:0:0:173e:2e66 + - queryTime: '2026-04-09' + domainName: example.com. + dnsTypes: + AAAA: 28 + A: 1 + dnsRecords: + - name: example.com + type: 1 + dnsType: A + ttl: 300 + rawText: "example.com.\t\t300\tIN\tA\t104.18.27.120" + rRsetType: 1 + address: 104.18.27.120 + - name: example.com + type: 1 + dnsType: A + ttl: 300 + rawText: "example.com.\t\t300\tIN\tA\t104.18.26.120" + rRsetType: 1 + address: 104.18.26.120 + - name: example.com + type: 28 + dnsType: AAAA + ttl: 300 + rawText: "example.com.\t\t300\tIN\tAAAA\t2606:4700:0:0:0:0:6812:1b78" + rRsetType: 28 + address: 2606:4700:0:0:0:0:6812:1b78 + - name: example.com + type: 28 + dnsType: AAAA + ttl: 300 + rawText: "example.com.\t\t300\tIN\tAAAA\t2606:4700:0:0:0:0:6812:1a78" + rRsetType: 28 + address: 2606:4700:0:0:0:0:6812:1a78 + - queryTime: '2024-12-17' + domainName: example.com. + dnsTypes: + AAAA: 28 + TXT: 16 + A: 1 + dnsRecords: + - name: example.com + type: 1 + dnsType: A + ttl: 1925 + rawText: "example.com.\t\t1925\tIN\tA\t93.184.215.14" + rRsetType: 1 + address: 93.184.215.14 + - name: example.com + type: 28 + dnsType: AAAA + ttl: 581 + rawText: "example.com.\t\t581\tIN\tAAAA\t2606:2800:21f:cb07:6820:80da:af6b:8b2c" + rRsetType: 28 + address: 2606:2800:21f:cb07:6820:80da:af6b:8b2c + - name: example.com + type: 16 + dnsType: TXT + ttl: 21600 + rawText: "example.com.\t\t21600\tIN\tTXT\t\"wgyf8z8cgvm2qmxpnbnldrcltvk4xqfn\"" + rRsetType: 16 + strings: + - wgyf8z8cgvm2qmxpnbnldrcltvk4xqfn + - queryTime: '2026-06-08' + domainName: example.com. + dnsTypes: + SOA: 6 + AAAA: 28 + TXT: 16 + A: 1 + NS: 2 + MX: 15 + SPF: 99 + dnsRecords: + - name: example.com + type: 1 + dnsType: A + ttl: 300 + rawText: "example.com.\t\t300\tIN\tA\t104.20.23.154" + rRsetType: 1 + address: 104.20.23.154 + - name: example.com + type: 1 + dnsType: A + ttl: 300 + rawText: "example.com.\t\t300\tIN\tA\t172.66.147.243" + rRsetType: 1 + address: 172.66.147.243 + - name: example.com + type: 28 + dnsType: AAAA + ttl: 300 + rawText: "example.com.\t\t300\tIN\tAAAA\t2606:4700:10:0:0:0:6814:179a" + rRsetType: 28 + address: 2606:4700:10:0:0:0:6814:179a + - name: example.com + type: 28 + dnsType: AAAA + ttl: 300 + rawText: "example.com.\t\t300\tIN\tAAAA\t2606:4700:10:0:0:0:ac42:93f3" + rRsetType: 28 + address: 2606:4700:10:0:0:0:ac42:93f3 + - name: example.com + type: 6 + dnsType: SOA + ttl: 627 + rawText: "example.com.\t\t627\tIN\tSOA\telliott.ns.cloudflare.com. dns.cloudflare.com.\ + \ 2391407559 10000 2400 604800 1800" + rRsetType: 6 + admin: dns.cloudflare.com. + host: elliott.ns.cloudflare.com. + expire: 604800 + minimum: 1800 + refresh: 10000 + retry: 2400 + serial: 2391407559 + - name: example.com + type: 16 + dnsType: TXT + ttl: 10694 + rawText: "example.com.\t\t10694\tIN\tTXT\t\"_k2n1y4vw3qtb4skdx9e7dxt97qrmmq9\"" + rRsetType: 16 + strings: + - _k2n1y4vw3qtb4skdx9e7dxt97qrmmq9 + - name: example.com + type: 15 + dnsType: MX + ttl: 21600 + rawText: "example.com.\t\t21600\tIN\tMX\t0 ." + rRsetType: 15 + target: . + priority: 0 + - name: example.com + type: 99 + dnsType: SPF + ttl: 21600 + rawText: "example.com.\t\t21600\tIN\tSPF\t\"v=spf1 -all\"" + rRsetType: 99 + strings: + - v=spf1 -all + - name: example.com + type: 2 + dnsType: NS + ttl: 20464 + rawText: "example.com.\t\t20464\tIN\tNS\thera.ns.cloudflare.com." + rRsetType: 2 + singleName: hera.ns.cloudflare.com. + - name: example.com + type: 2 + dnsType: NS + ttl: 20464 + rawText: "example.com.\t\t20464\tIN\tNS\telliott.ns.cloudflare.com." + rRsetType: 2 + singleName: elliott.ns.cloudflare.com. + - queryTime: '2024-03-11' + domainName: example.com. + dnsTypes: + AAAA: 28 + A: 1 + dnsRecords: + - name: example.com + type: 1 + dnsType: A + ttl: 21600 + rawText: "example.com.\t\t21600\tIN\tA\t93.184.216.34" + rRsetType: 1 + address: 93.184.216.34 + - name: example.com + type: 28 + dnsType: AAAA + ttl: 21600 + rawText: "example.com.\t\t21600\tIN\tAAAA\t2606:2800:220:1:248:1893:25c8:1946" + rRsetType: 28 + address: 2606:2800:220:1:248:1893:25c8:1946 + '400': + description: Invalid DNS type + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:09:36.260Z' + path: /v1.0/domain/dns/history + status: 400 + error: Invalid DNS Type Exception + message: 'Please provide correct dns records type(s) [For Technical Support: support@whoisfreaks.com]' + '404': + description: No DNS history records for domain + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:09:36.260Z' + path: /v1.0/domain/dns/history + status: 404 + error: Record Not Found + message: 'No Record Found across: ' + '408': + description: Request Timeout + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:09:36.260Z' + path: /v1.0/domain/dns/history + status: 408 + error: Request Timeout + message: 'Unable to fetch dns records. Please try after some time. [For Technical Support + email at: support@whoisfreaks.com]' + '503': + description: Service Unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:09:36.260Z' + path: /v1.0/domain/dns/history + status: 503 + error: Service Unavailable + message: Service is unavailable. + '504': + description: Gateway Timeout + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:09:36.260Z' + path: /v1.0/domain/dns/history + status: 504 + error: Gateway Timeout + message: Request is timed-out. + security: + - ApiKeyAuth: [] + /v1.0/domain/dns/reverse: + get: + tags: + - DNS + summary: Retrieve all the hostnames associated with any particular A, AAAA, MX, NS, SOA, SPF, TXT, + and CNAME DNS records. + description: 'Retrieve all the hostnames associated with any particular A, AAAA, MX, NS, SOA, SPF, + TXT, and CNAME DNS records. For instance, you can access all the hostnames hosted on any IP/CIDR + notation, all the domain names using Cloudflare name servers, and all the domain names using Google + Mailbox + + ' + operationId: reverseDnsLookup + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - name: type + in: query + required: true + schema: + type: string + enum: + - A + - AAAA + - MX + - NS + - SOA + - SPF + - TXT + - CNAME + description: 'The type of reverse DNS lookup to perform. Determines how the value parameter is + interpreted: + + - A: IPv4 CIDR block + + - AAAA: IPv6 CIDR block + + - MX: Mail provider domain + + - NS: Name server provider hostname + + - SOA: SOA record admin domain + + - SPF/TXT: Target verification strings + + - CNAME: Target hostname + + ' + - name: value + in: query + required: true + schema: + type: string + description: Provide an IP or CIDR for A/AAAA lookups, or a hostname/selector for MX, NS, SOA, + SPF, TXT, and CNAME queries. Wildcard regex patterns are also supported (e.g., mail.google.com, + m*.google.com, _spf.g*.com, s*.g*.com). + - name: exact + in: query + required: false + schema: + type: boolean + default: false + description: Accepts 'true' or 'false'. "true" returns only records that exactly match the input + (NS, MX, CNAME, SOA, SPF, TXT). "false" returns all matches (default when omitted). + - name: page + in: query + required: false + schema: + type: integer + minimum: 1 + default: 1 + description: Page number to paginate through results (defaults to 1). + responses: + '200': + description: Successful Response + content: + application/json: + schema: + $ref: '#/components/schemas/DnsReverseDnsResponse' + example: + totalRecords: 89950 + totalPages: 900 + currentPage: 1 + reverseDnsRecords: + - queryTime: '2024-05-30' + domainName: www.maguire.romamenu.cotest.avalon-invest.pro + dnsTypes: + A: 1 + dnsRecords: + - name: www.maguire.romamenu.cotest.avalon-invest.pro + type: 1 + dnsType: A + ttl: 300 + rawText: "www.maguire.romamenu.cotest.avalon-invest.pro.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-06-13' + domainName: qa-allure.salt-dev.ws + dnsTypes: + A: 1 + dnsRecords: + - name: qa-allure.salt-dev.ws + type: 1 + dnsType: A + ttl: 300 + rawText: "qa-allure.salt-dev.ws.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-03-21' + domainName: www.hailibu.cn + dnsTypes: + A: 1 + dnsRecords: + - name: www.hailibu.cn + type: 1 + dnsType: A + ttl: 1 + rawText: "www.hailibu.cn.\t\t1\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-07-08' + domainName: j-legacyconsultants.co.za + dnsTypes: + A: 1 + dnsRecords: + - name: j-legacyconsultants.co.za + type: 1 + dnsType: A + ttl: 3600 + rawText: "j-legacyconsultants.co.za.\t3600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-03-24' + domainName: www.ebdisk.hacklink.site + dnsTypes: + A: 1 + dnsRecords: + - name: www.ebdisk.hacklink.site + type: 1 + dnsType: A + ttl: 120 + rawText: "www.ebdisk.hacklink.site.\t120\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-02-12' + domainName: alfredp2p.store + dnsTypes: + A: 1 + dnsRecords: + - name: alfredp2p.store + type: 1 + dnsType: A + ttl: 120 + rawText: "alfredp2p.store.\t120\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-06-14' + domainName: henglinongye.cn + dnsTypes: + A: 1 + dnsRecords: + - name: henglinongye.cn + type: 1 + dnsType: A + ttl: 600 + rawText: "henglinongye.cn.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-06-12' + domainName: 11tebingbagus.tech + dnsTypes: + A: 1 + dnsRecords: + - name: 11tebingbagus.tech + type: 1 + dnsType: A + ttl: 300 + rawText: "11tebingbagus.tech.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-07-15' + domainName: cangzhou045849.11467.com + dnsTypes: + A: 1 + dnsRecords: + - name: cangzhou045849.11467.com + type: 1 + dnsType: A + ttl: 600 + rawText: "cangzhou045849.11467.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-07-15' + domainName: huzhou048893.11467.com + dnsTypes: + A: 1 + dnsRecords: + - name: huzhou048893.11467.com + type: 1 + dnsType: A + ttl: 600 + rawText: "huzhou048893.11467.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-06-14' + domainName: www.uwugdgit.paypall.de + dnsTypes: + A: 1 + dnsRecords: + - name: www.uwugdgit.paypall.de + type: 1 + dnsType: A + ttl: 300 + rawText: "www.uwugdgit.paypall.de.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-04-21' + domainName: dtempurl.com + dnsTypes: + A: 1 + dnsRecords: + - name: dtempurl.com + type: 1 + dnsType: A + ttl: 3600 + rawText: "dtempurl.com.\t\t3600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-14' + domainName: barry-2.usevchala.cfd + dnsTypes: + A: 1 + dnsRecords: + - name: barry-2.usevchala.cfd + type: 1 + dnsType: A + ttl: 300 + rawText: "barry-2.usevchala.cfd.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-03-02' + domainName: www.paguebit.site + dnsTypes: + A: 1 + dnsRecords: + - name: www.paguebit.site + type: 1 + dnsType: A + ttl: 120 + rawText: "www.paguebit.site.\t120\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-03-22' + domainName: zain760-001-site1.site4future.com + dnsTypes: + A: 1 + dnsRecords: + - name: zain760-001-site1.site4future.com + type: 1 + dnsType: A + ttl: 300 + rawText: "zain760-001-site1.site4future.com.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-12' + domainName: susie4128.trustexporter.com + dnsTypes: + A: 1 + dnsRecords: + - name: susie4128.trustexporter.com + type: 1 + dnsType: A + ttl: 600 + rawText: "susie4128.trustexporter.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-08' + domainName: jsbr2.cn.trustexporter.com + dnsTypes: + A: 1 + dnsRecords: + - name: jsbr2.cn.trustexporter.com + type: 1 + dnsType: A + ttl: 600 + rawText: "jsbr2.cn.trustexporter.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-03-17' + domainName: www.status.dev.forum.njpprnffwwmic.site + dnsTypes: + A: 1 + dnsRecords: + - name: www.status.dev.forum.njpprnffwwmic.site + type: 1 + dnsType: A + ttl: 120 + rawText: "www.status.dev.forum.njpprnffwwmic.site.\t120\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-06-16' + domainName: bagusdisin19.tech + dnsTypes: + A: 1 + dnsRecords: + - name: bagusdisin19.tech + type: 1 + dnsType: A + ttl: 300 + rawText: "bagusdisin19.tech.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-06-24' + domainName: mostafanaeem55-001-site1.otempurl.com + dnsTypes: + A: 1 + dnsRecords: + - name: mostafanaeem55-001-site1.otempurl.com + type: 1 + dnsType: A + ttl: 300 + rawText: "mostafanaeem55-001-site1.otempurl.com.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-02-20' + domainName: root.fivaraapp.store + dnsTypes: + A: 1 + dnsRecords: + - name: root.fivaraapp.store + type: 1 + dnsType: A + ttl: 120 + rawText: "root.fivaraapp.store.\t120\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-02-13' + domainName: vodka-casino5.top + dnsTypes: + A: 1 + dnsRecords: + - name: vodka-casino5.top + type: 1 + dnsType: A + ttl: 120 + rawText: "vodka-casino5.top.\t120\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-10' + domainName: mail.fourarrowsinn.com + dnsTypes: + A: 1 + dnsRecords: + - name: mail.fourarrowsinn.com + type: 1 + dnsType: A + ttl: 300 + rawText: "mail.fourarrowsinn.com.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-02-13' + domainName: uos.vn + dnsTypes: + A: 1 + dnsRecords: + - name: uos.vn + type: 1 + dnsType: A + ttl: 300 + rawText: "uos.vn.\t\t\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-02-10' + domainName: kompongdewapay.net + dnsTypes: + A: 1 + dnsRecords: + - name: kompongdewapay.net + type: 1 + dnsType: A + ttl: 300 + rawText: "kompongdewapay.net.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-07-14' + domainName: gulshanyadav-001-site1.ltempurl.com + dnsTypes: + A: 1 + dnsRecords: + - name: gulshanyadav-001-site1.ltempurl.com + type: 1 + dnsType: A + ttl: 300 + rawText: "gulshanyadav-001-site1.ltempurl.com.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-22' + domainName: daisy86517.trustexporter.com + dnsTypes: + A: 1 + dnsRecords: + - name: daisy86517.trustexporter.com + type: 1 + dnsType: A + ttl: 600 + rawText: "daisy86517.trustexporter.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-06-11' + domainName: prod.core.techklemo.com + dnsTypes: + A: 1 + dnsRecords: + - name: prod.core.techklemo.com + type: 1 + dnsType: A + ttl: 300 + rawText: "prod.core.techklemo.com.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-07-21' + domainName: xn--bvs063a.cc + dnsTypes: + A: 1 + dnsRecords: + - name: xn--bvs063a.cc + type: 1 + dnsType: A + ttl: 300 + rawText: "xn--bvs063a.cc.\t\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-04-01' + domainName: play.jewelflora.store + dnsTypes: + A: 1 + dnsRecords: + - name: play.jewelflora.store + type: 1 + dnsType: A + ttl: 120 + rawText: "play.jewelflora.store.\t120\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-02-19' + domainName: blog.nayagara.store + dnsTypes: + A: 1 + dnsRecords: + - name: blog.nayagara.store + type: 1 + dnsType: A + ttl: 120 + rawText: "blog.nayagara.store.\t120\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-02-04' + domainName: stansen.com.cn + dnsTypes: + A: 1 + dnsRecords: + - name: stansen.com.cn + type: 1 + dnsType: A + ttl: 600 + rawText: "stansen.com.cn.\t\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-05-27' + domainName: loja.lagosgp.com.br + dnsTypes: + A: 1 + dnsRecords: + - name: loja.lagosgp.com.br + type: 1 + dnsType: A + ttl: 14400 + rawText: "loja.lagosgp.com.br.\t14400\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-07-09' + domainName: aigcchk.com + dnsTypes: + A: 1 + dnsRecords: + - name: aigcchk.com + type: 1 + dnsType: A + ttl: 600 + rawText: "aigcchk.com.\t\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-07' + domainName: kuaixiu800.cn.trustexporter.com + dnsTypes: + A: 1 + dnsRecords: + - name: kuaixiu800.cn.trustexporter.com + type: 1 + dnsType: A + ttl: 600 + rawText: "kuaixiu800.cn.trustexporter.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-06-16' + domainName: petsparadise.com.cn + dnsTypes: + A: 1 + dnsRecords: + - name: petsparadise.com.cn + type: 1 + dnsType: A + ttl: 600 + rawText: "petsparadise.com.cn.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-08-10' + domainName: unifi.lillebry.duckdns.org + dnsTypes: + A: 1 + dnsRecords: + - name: unifi.lillebry.duckdns.org + type: 1 + dnsType: A + ttl: 60 + rawText: "unifi.lillebry.duckdns.org.\t60\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-06-09' + domainName: billsgoodread.com + dnsTypes: + A: 1 + dnsRecords: + - name: billsgoodread.com + type: 1 + dnsType: A + ttl: 3600 + rawText: "billsgoodread.com.\t3600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-06-08' + domainName: deepl-pro.com + dnsTypes: + A: 1 + dnsRecords: + - name: deepl-pro.com + type: 1 + dnsType: A + ttl: 60 + rawText: "deepl-pro.com.\t\t60\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-03-15' + domainName: www.login.mc33.fun + dnsTypes: + A: 1 + dnsRecords: + - name: www.login.mc33.fun + type: 1 + dnsType: A + ttl: 120 + rawText: "www.login.mc33.fun.\t120\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-02-04' + domainName: redo-design.cn + dnsTypes: + A: 1 + dnsRecords: + - name: redo-design.cn + type: 1 + dnsType: A + ttl: 600 + rawText: "redo-design.cn.\t\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-06-01' + domainName: deluge.tristan.moe + dnsTypes: + A: 1 + dnsRecords: + - name: deluge.tristan.moe + type: 1 + dnsType: A + ttl: 300 + rawText: "deluge.tristan.moe.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-05-10' + domainName: hapalowsky.duckdns.org + dnsTypes: + A: 1 + dnsRecords: + - name: hapalowsky.duckdns.org + type: 1 + dnsType: A + ttl: 60 + rawText: "hapalowsky.duckdns.org.\t60\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-06-10' + domainName: njbxkj.com + dnsTypes: + A: 1 + dnsRecords: + - name: njbxkj.com + type: 1 + dnsType: A + ttl: 600 + rawText: "njbxkj.com.\t\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-03-17' + domainName: dave.dev.taskassembly.com + dnsTypes: + A: 1 + dnsRecords: + - name: dave.dev.taskassembly.com + type: 1 + dnsType: A + ttl: 300 + rawText: "dave.dev.taskassembly.com.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-03-31' + domainName: www.facinomx.com + dnsTypes: + A: 1 + dnsRecords: + - name: www.facinomx.com + type: 1 + dnsType: A + ttl: 600 + rawText: "www.facinomx.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-12' + domainName: uranustarltd.trustexporter.com + dnsTypes: + A: 1 + dnsRecords: + - name: uranustarltd.trustexporter.com + type: 1 + dnsType: A + ttl: 600 + rawText: "uranustarltd.trustexporter.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-04-01' + domainName: hnconstructionlk.mrdhanu.com + dnsTypes: + A: 1 + dnsRecords: + - name: hnconstructionlk.mrdhanu.com + type: 1 + dnsType: A + ttl: 900 + rawText: "hnconstructionlk.mrdhanu.com.\t900\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-06-15' + domainName: wbom.epfresh.cn + dnsTypes: + A: 1 + dnsRecords: + - name: wbom.epfresh.cn + type: 1 + dnsType: A + ttl: 600 + rawText: "wbom.epfresh.cn.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-07-05' + domainName: huobing88.xyz + dnsTypes: + A: 1 + dnsRecords: + - name: huobing88.xyz + type: 1 + dnsType: A + ttl: 300 + rawText: "huobing88.xyz.\t\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-23' + domainName: test.cpne.it + dnsTypes: + A: 1 + dnsRecords: + - name: test.cpne.it + type: 1 + dnsType: A + ttl: 300 + rawText: "test.cpne.it.\t\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-03-19' + domainName: cpanel.beta1.magas.services + dnsTypes: + A: 1 + dnsRecords: + - name: cpanel.beta1.magas.services + type: 1 + dnsType: A + ttl: 300 + rawText: "cpanel.beta1.magas.services.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-05-08' + domainName: hackerblog.nl + dnsTypes: + A: 1 + dnsRecords: + - name: hackerblog.nl + type: 1 + dnsType: A + ttl: 60 + rawText: "hackerblog.nl.\t\t60\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-22' + domainName: testeasy08.trustexporter.com + dnsTypes: + A: 1 + dnsRecords: + - name: testeasy08.trustexporter.com + type: 1 + dnsType: A + ttl: 600 + rawText: "testeasy08.trustexporter.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-05-05' + domainName: sierraleone-uat.healthcare.sandtech.app + dnsTypes: + A: 1 + dnsRecords: + - name: sierraleone-uat.healthcare.sandtech.app + type: 1 + dnsType: A + ttl: 300 + rawText: "sierraleone-uat.healthcare.sandtech.app.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-02-21' + domainName: pro.market.120uu3.top + dnsTypes: + A: 1 + dnsRecords: + - name: pro.market.120uu3.top + type: 1 + dnsType: A + ttl: 120 + rawText: "pro.market.120uu3.top.\t120\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-22' + domainName: feiyuanglq.trustexporter.com + dnsTypes: + A: 1 + dnsRecords: + - name: feiyuanglq.trustexporter.com + type: 1 + dnsType: A + ttl: 600 + rawText: "feiyuanglq.trustexporter.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-20' + domainName: hyjc88.cn.trustexporter.com + dnsTypes: + A: 1 + dnsRecords: + - name: hyjc88.cn.trustexporter.com + type: 1 + dnsType: A + ttl: 600 + rawText: "hyjc88.cn.trustexporter.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-04-23' + domainName: szjcmc.cn + dnsTypes: + A: 1 + dnsRecords: + - name: szjcmc.cn + type: 1 + dnsType: A + ttl: 600 + rawText: "szjcmc.cn.\t\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-03-02' + domainName: m.hbxinchen.cn + dnsTypes: + A: 1 + dnsRecords: + - name: m.hbxinchen.cn + type: 1 + dnsType: A + ttl: 600 + rawText: "m.hbxinchen.cn.\t\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-22' + domainName: alliancesupplier.trustexporter.com + dnsTypes: + A: 1 + dnsRecords: + - name: alliancesupplier.trustexporter.com + type: 1 + dnsType: A + ttl: 600 + rawText: "alliancesupplier.trustexporter.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-07-04' + domainName: ggl7.com + dnsTypes: + A: 1 + dnsRecords: + - name: ggl7.com + type: 1 + dnsType: A + ttl: 600 + rawText: "ggl7.com.\t\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-05-09' + domainName: kiori-collection.com + dnsTypes: + A: 1 + dnsRecords: + - name: kiori-collection.com + type: 1 + dnsType: A + ttl: 696 + rawText: "kiori-collection.com.\t696\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-04-25' + domainName: fegosofa.com + dnsTypes: + A: 1 + dnsRecords: + - name: fegosofa.com + type: 1 + dnsType: A + ttl: 3600 + rawText: "fegosofa.com.\t\t3600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-12' + domainName: mayflower2015.cn.trustexporter.com + dnsTypes: + A: 1 + dnsRecords: + - name: mayflower2015.cn.trustexporter.com + type: 1 + dnsType: A + ttl: 600 + rawText: "mayflower2015.cn.trustexporter.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-02-17' + domainName: log.105uu8.top + dnsTypes: + A: 1 + dnsRecords: + - name: log.105uu8.top + type: 1 + dnsType: A + ttl: 120 + rawText: "log.105uu8.top.\t\t120\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-02-24' + domainName: demo.testing.mc33.fun + dnsTypes: + A: 1 + dnsRecords: + - name: demo.testing.mc33.fun + type: 1 + dnsType: A + ttl: 120 + rawText: "demo.testing.mc33.fun.\t120\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-07-12' + domainName: 83367.top + dnsTypes: + A: 1 + dnsRecords: + - name: 83367.top + type: 1 + dnsType: A + ttl: 600 + rawText: "83367.top.\t\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-12-04' + domainName: rt.us.ci + dnsTypes: + A: 1 + dnsRecords: + - name: rt.us.ci + type: 1 + dnsType: A + ttl: 14400 + rawText: "rt.us.ci.\t\t14400\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-02-27' + domainName: dev.tdpf.metro.tokyo.lg.jp + dnsTypes: + A: 1 + dnsRecords: + - name: dev.tdpf.metro.tokyo.lg.jp + type: 1 + dnsType: A + ttl: 300 + rawText: "dev.tdpf.metro.tokyo.lg.jp.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-06-11' + domainName: clevelandballet.org + dnsTypes: + A: 1 + dnsRecords: + - name: clevelandballet.org + type: 1 + dnsType: A + ttl: 3600 + rawText: "clevelandballet.org.\t3600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-03-27' + domainName: www.ze.okplay-deuces.online + dnsTypes: + A: 1 + dnsRecords: + - name: www.ze.okplay-deuces.online + type: 1 + dnsType: A + ttl: 120 + rawText: "www.ze.okplay-deuces.online.\t120\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-02-18' + domainName: www.bujuyige.com + dnsTypes: + A: 1 + dnsRecords: + - name: www.bujuyige.com + type: 1 + dnsType: A + ttl: 600 + rawText: "www.bujuyige.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-04-30' + domainName: 34034.xyz + dnsTypes: + A: 1 + dnsRecords: + - name: 34034.xyz + type: 1 + dnsType: A + ttl: 300 + rawText: "34034.xyz.\t\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-06-12' + domainName: bushouston.com + dnsTypes: + A: 1 + dnsRecords: + - name: bushouston.com + type: 1 + dnsType: A + ttl: 600 + rawText: "bushouston.com.\t\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-05-05' + domainName: comfybelt.de + dnsTypes: + A: 1 + dnsRecords: + - name: comfybelt.de + type: 1 + dnsType: A + ttl: 300 + rawText: "comfybelt.de.\t\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-05-08' + domainName: alphainfuse.co + dnsTypes: + A: 1 + dnsRecords: + - name: alphainfuse.co + type: 1 + dnsType: A + ttl: 21600 + rawText: "alphainfuse.co.\t\t21600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-06-15' + domainName: experiencereality.us + dnsTypes: + A: 1 + dnsRecords: + - name: experiencereality.us + type: 1 + dnsType: A + ttl: 300 + rawText: "experiencereality.us.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2024-09-02' + domainName: mail.server.linuxtest.xyz + dnsTypes: + A: 1 + dnsRecords: + - name: mail.server.linuxtest.xyz + type: 1 + dnsType: A + ttl: 300 + rawText: "mail.server.linuxtest.xyz.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-05-07' + domainName: moblys67.win + dnsTypes: + A: 1 + dnsRecords: + - name: moblys67.win + type: 1 + dnsType: A + ttl: 300 + rawText: "moblys67.win.\t\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-11' + domainName: gangzhicheng.cn.trustexporter.com + dnsTypes: + A: 1 + dnsRecords: + - name: gangzhicheng.cn.trustexporter.com + type: 1 + dnsType: A + ttl: 600 + rawText: "gangzhicheng.cn.trustexporter.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-09-09' + domainName: vip07.ctbymh.com + dnsTypes: + A: 1 + dnsRecords: + - name: vip07.ctbymh.com + type: 1 + dnsType: A + ttl: 600 + rawText: "vip07.ctbymh.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-02-23' + domainName: www.ws.fivaraapp.store + dnsTypes: + A: 1 + dnsRecords: + - name: www.ws.fivaraapp.store + type: 1 + dnsType: A + ttl: 120 + rawText: "www.ws.fivaraapp.store.\t120\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-06-16' + domainName: terminleme.com + dnsTypes: + A: 1 + dnsRecords: + - name: terminleme.com + type: 1 + dnsType: A + ttl: 300 + rawText: "terminleme.com.\t\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-05' + domainName: ad08.hhisdk1.com + dnsTypes: + A: 1 + dnsRecords: + - name: ad08.hhisdk1.com + type: 1 + dnsType: A + ttl: 600 + rawText: "ad08.hhisdk1.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-18' + domainName: btbyywj.cn.trustexporter.com + dnsTypes: + A: 1 + dnsRecords: + - name: btbyywj.cn.trustexporter.com + type: 1 + dnsType: A + ttl: 600 + rawText: "btbyywj.cn.trustexporter.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-06-08' + domainName: superstalin.top + dnsTypes: + A: 1 + dnsRecords: + - name: superstalin.top + type: 1 + dnsType: A + ttl: 7200 + rawText: "superstalin.top.\t7200\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-03-19' + domainName: dev.staging.ipv6.deroqq.sbs + dnsTypes: + A: 1 + dnsRecords: + - name: dev.staging.ipv6.deroqq.sbs + type: 1 + dnsType: A + ttl: 120 + rawText: "dev.staging.ipv6.deroqq.sbs.\t120\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-12' + domainName: tb777777.cn.trustexporter.com + dnsTypes: + A: 1 + dnsRecords: + - name: tb777777.cn.trustexporter.com + type: 1 + dnsType: A + ttl: 600 + rawText: "tb777777.cn.trustexporter.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-03-16' + domainName: 0u12d.v6t7x3y1k9r2b4w5m0p8jzn.top + dnsTypes: + A: 1 + dnsRecords: + - name: 0u12d.v6t7x3y1k9r2b4w5m0p8jzn.top + type: 1 + dnsType: A + ttl: 120 + rawText: "0u12d.v6t7x3y1k9r2b4w5m0p8jzn.top.\t120\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-05-30' + domainName: shahrad.synology.me + dnsTypes: + A: 1 + dnsRecords: + - name: shahrad.synology.me + type: 1 + dnsType: A + ttl: 240 + rawText: "shahrad.synology.me.\t240\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2024-11-22' + domainName: www.tcsydj.cn + dnsTypes: + A: 1 + dnsRecords: + - name: www.tcsydj.cn + type: 1 + dnsType: A + ttl: 600 + rawText: "www.tcsydj.cn.\t\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-12' + domainName: lyra.trustexporter.com + dnsTypes: + A: 1 + dnsRecords: + - name: lyra.trustexporter.com + type: 1 + dnsType: A + ttl: 600 + rawText: "lyra.trustexporter.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-02-15' + domainName: exploratorio.art + dnsTypes: + A: 1 + dnsRecords: + - name: exploratorio.art + type: 1 + dnsType: A + ttl: 120 + rawText: "exploratorio.art.\t120\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-22' + domainName: lingerie01.trustexporter.com + dnsTypes: + A: 1 + dnsRecords: + - name: lingerie01.trustexporter.com + type: 1 + dnsType: A + ttl: 600 + rawText: "lingerie01.trustexporter.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-07-15' + domainName: guangzhou0753912.11467.com + dnsTypes: + A: 1 + dnsRecords: + - name: guangzhou0753912.11467.com + type: 1 + dnsType: A + ttl: 600 + rawText: "guangzhou0753912.11467.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-07-06' + domainName: takeit.ma + dnsTypes: + A: 1 + dnsRecords: + - name: takeit.ma + type: 1 + dnsType: A + ttl: 14400 + rawText: "takeit.ma.\t\t14400\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-07-14' + domainName: carbonsystem-001-site1.jtempurl.com + dnsTypes: + A: 1 + dnsRecords: + - name: carbonsystem-001-site1.jtempurl.com + type: 1 + dnsType: A + ttl: 300 + rawText: "carbonsystem-001-site1.jtempurl.com.\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2026-03-31' + domainName: 12.bestclub.rs + dnsTypes: + A: 1 + dnsRecords: + - name: 12.bestclub.rs + type: 1 + dnsType: A + ttl: 300 + rawText: "12.bestclub.rs.\t\t300\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + - queryTime: '2025-10-23' + domainName: baihengbag.cn.trustexporter.com + dnsTypes: + A: 1 + dnsRecords: + - name: baihengbag.cn.trustexporter.com + type: 1 + dnsType: A + ttl: 600 + rawText: "baihengbag.cn.trustexporter.com.\t600\tIN\tA\t8.8.8.8" + rRsetType: 1 + address: 8.8.8.8 + '400': + description: Invalid Dns Type + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:09:36.260Z' + path: /v1.0/domain/dns/reverse + status: 400 + error: Invalid DNS Type Exception + message: Invalid dns Record Type. Kindly use the supported record types. + '404': + description: No reverse DNS records + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:09:36.260Z' + path: /v1.0/domain/dns/reverse + status: 404 + error: Record Not Found + message: No Record Found. + '408': + description: Request Timeout + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:09:36.260Z' + path: /v1.0/domain/dns/reverse + status: 408 + error: Request Timeout + message: 'Unable to fetch dns records. Please try again [For Technical Support: support@whoisfreaks.com].' + '503': + description: Service Unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:09:36.260Z' + path: /v1.0/domain/dns/reverse + status: 503 + error: Service Unavailable + message: Service is unavailable. + '504': + description: Gateway Timeout + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:09:36.260Z' + path: /v1.0/domain/dns/reverse + status: 504 + error: Gateway Timeout + message: Request is timed-out. + security: + - ApiKeyAuth: [] + /v1.0/domain/availability: + get: + tags: + - Domain + summary: Check whether a domain is available for registration or not. + description: The Domain Search API is designed to simplify the process of finding available domain + names across all top-level domains (TLDs) and second-level domains (SLDs). + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - name: domain + in: query + required: true + schema: + type: string + description: Domain name whose availability is to be checked. + - name: source + in: query + required: false + schema: + type: string + enum: + - dns + - whois + default: dns + description: Specify the data source for domain availability checks. Use "dns" for DNS-based lookups + or "whois" for WHOIS-based lookups. By default, "dns" is used. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/DomainDomainAvailabilityResponse' + example: + domain: google.com + domainAvailability: false + '400': + description: Bad Request – Invalid domain parameter + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:37:02.237Z' + status: 400 + error: Invalid Param Exception + message: 'Please pass domain param correct value [For Technical Support: support@whoisfreaks.com]' + path: /v1.0/domain/availability + '403': + description: Forbidden – Inactive TLD + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + examples: + Not Supported Domain extension: {} + Inactive TLD: {} + '408': + description: Request Timeout – Unable to fetch WHOIS data + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:37:21.871Z' + status: 408 + error: Request Timeout + message: 'Unable to fetch whois data. Please try again. [For Technical Support email at: + support@whoisfreaks.com]' + path: /v1.0/domain/availability + '503': + description: Service Unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:37:02.237Z' + status: 503 + error: Service Unavailable + message: 'Service is unavailable. Please try after some time. [For Technical Support email + at: support@whoisfreaks.com]' + path: /v1.0/domain/availability + security: + - ApiKeyAuth: [] + operationId: getDomainAvailability + post: + tags: + - Domain + summary: Check the availability of multiple domains in a single request. + description: Perform Bulk Domain Availability checks using a list of domains. Supports upto `100 + Domains Per Request`. + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - name: source + in: query + required: false + schema: + type: string + enum: + - dns + - whois + default: dns + description: Specify the data source for domain availability checks. Use "dns" for DNS-based lookups + or "whois" for WHOIS-based lookups. By default, "dns" is used. + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - domainNames + properties: + domainNames: + type: array + items: + type: string + description: List of domain names to check. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/DomainBulkDomainSuggestionResponse' + example: + bulk_domain_availability_response: + - domain: bannu.in + domainAvailability: false + status: true + - domain: techguruss.com + domainAvailability: true + status: true + '206': + description: Partial Success + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:37:02.237Z' + status: 206 + error: Partial Success + message: Partial response, as an error occurred while processing the request. + path: /v1.0/domain/availability + '403': + description: Forbidden + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + examples: + Domain extension not supported: {} + Inactive TLD: {} + '408': + description: Request Timeout – Unable to fetch WHOIS data + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:37:21.871Z' + status: 408 + error: Request Timeout + message: 'Unable to fetch whois data. Please try again. [For Technical Support email at: + support@whoisfreaks.com]' + path: /v1.0/domain/availability + '503': + description: Service Unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:37:02.237Z' + status: 503 + error: Service Unavailable + message: 'Service is unavailable. Please try after some time. [For Technical Support email + at: support@whoisfreaks.com]' + path: /v1.0/domain/availability + security: + - ApiKeyAuth: [] + operationId: postDomainAvailability + /v1.0/domain/availability/suggestions: + get: + tags: + - Domain + summary: Check domain availability and receive suggestions for related domains. + description: The Domain Search API is designed to simplify the process of finding available domain + names across all top-level domains (TLDs) and second-level domains (SLDs). + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - name: domain + in: query + required: true + schema: + type: string + description: Domain name for availability and suggestions. + - name: source + in: query + required: false + schema: + type: string + enum: + - dns + - whois + default: dns + description: Specify the data source for domain availability checks. Use "dns" for DNS-based lookups + or "whois" for WHOIS-based lookups. By default, "dns" is used. + - name: count + in: query + required: false + schema: + type: integer + default: 5 + description: Number of suggestions to retrieve. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/DomainDomainSuggestionResponse' + example: + domain_available_response: + - domain: acme.dev + domainAvailability: true + - domain: acme.org + domainAvailability: true + - domain: acme.info + domainAvailability: true + - domain: acme.net + domainAvailability: true + - domain: acme.com + domainAvailability: false + '400': + description: Bad Request – Invalid domain parameter + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:37:36.122Z' + status: 400 + error: Invalid Param Exception + message: 'Please pass domain param correct value [For Technical Support: support@whoisfreaks.com]' + path: /v1.0/domain/availability/suggestions + '408': + description: Request Timeout – Unable to fetch WHOIS data + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:37:21.871Z' + status: 408 + error: Request Timeout + message: 'Unable to fetch whois data. Please try again. [For Technical Support email at: + support@whoisfreaks.com]' + path: /v1.0/domain/availability/suggestions + '503': + description: Service Unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:37:02.237Z' + status: 503 + error: Service Unavailable + message: 'Service is unavailable. Please try after some time. [For Technical Support email + at: support@whoisfreaks.com]' + path: /v1.0/domain/availability/suggestions + operationId: getDomainAvailabilitySuggestions + security: + - ApiKeyAuth: [] + /v1.0/subdomains/lookup: + get: + tags: + - Domain + summary: Get subdomains related to the given domain name. + description: The Subdomain Lookup API is designed to retrieve subdomains related to the given domain + name. It helps you explore subdomains that are available for registration or usage. + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - name: domain + in: query + required: true + schema: + type: string + description: Domain name for availability and suggestions. + - name: after + in: query + required: false + schema: + type: string + format: date + description: Filter subdomains seen after this date (format YYYY-MM-DD). + - name: before + in: query + required: false + schema: + type: string + format: date + description: Filter subdomains seen before this date( format YYYY-MM-DD). + - name: status + in: query + required: false + schema: + type: string + enum: + - active + - inactive + description: Filter subdomains by status (active or inactive). + - name: page + in: query + required: false + schema: + type: integer + default: 1 + description: Page number for paginated results. + responses: + '200': + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/DomainSubDomainResponse' + example: + domain: google.com + status: true + query_time: '2026-06-17T11:33:37.892722269' + current_page: 1 + total_pages: 3 + total_records: 299 + subdomains: + - subdomain: r2---sn-p5qddn7r.c.pack.google.com + first_seen: '2025-01-17' + last_seen: '2026-06-16' + inactive_from: '2026-06-16' + - subdomain: rr1---sn-p5qlsndk.c.drive.google.com + first_seen: '2025-02-10' + last_seen: '2025-10-04' + - subdomain: frame.ads-devel.qa.adz.google.com + first_seen: '2025-12-01' + last_seen: '2026-04-03' + - subdomain: c.drive.google.com + first_seen: '2025-12-09' + last_seen: '2026-02-26' + - subdomain: da.ext.google.com + first_seen: '2025-12-08' + last_seen: '2026-05-07' + - subdomain: frame.adwords-canary.qa.adz.google.com + first_seen: '2025-12-01' + last_seen: '2026-06-10' + - subdomain: datafusion-api-staging.cloud.google.com + first_seen: '2025-10-27' + last_seen: '2026-06-06' + - subdomain: c.docs.google.com + first_seen: '2025-12-09' + last_seen: '2026-06-01' + - subdomain: northamerica-northeast1.cloud.google.com + first_seen: '2025-11-27' + last_seen: '2026-06-14' + - subdomain: pa.clients6.google.com + first_seen: '2025-11-21' + last_seen: '2026-06-14' + - subdomain: europe-west9.cloud.google.com + first_seen: '2025-12-02' + last_seen: '2026-06-14' + - subdomain: test.devsite.corp.google.com + first_seen: '2025-11-25' + last_seen: '2026-06-06' + - subdomain: rr4---sn-p5qs7nsr.c.drive.google.com + first_seen: '2025-02-16' + last_seen: '2025-09-26' + inactive_from: '2025-09-26' + - subdomain: ics-devel-east.qa.adz.google.com + first_seen: '2025-12-01' + last_seen: '2026-04-03' + - subdomain: tbn6-beta.google.com + first_seen: '2025-06-15' + last_seen: '2026-02-25' + - subdomain: frame.canary.qa.adz.google.com + first_seen: '2025-12-01' + last_seen: '2026-04-03' + - subdomain: lookerstudio.me-central1.cloud.google.com + first_seen: '2025-02-26' + last_seen: '2026-06-06' + - subdomain: us-central2.cloud-run-qual.sandbox.google.com + first_seen: '2025-10-27' + last_seen: '2026-06-12' + - subdomain: focus.corp.google.com + first_seen: '2025-05-23' + last_seen: '2025-10-01' + inactive_from: '2025-10-01' + - subdomain: europe-west1.cloud.google.com + first_seen: '2025-11-27' + last_seen: '2026-06-13' + - subdomain: jules.google.com + first_seen: '2025-06-12' + last_seen: '2026-06-15' + - subdomain: machinelearningtools-autopush.cloud.google.com + first_seen: '2025-11-23' + last_seen: '2026-06-06' + inactive_from: '2026-06-06' + - subdomain: composer-dev.cloud.google.com + first_seen: '2025-10-27' + last_seen: '2026-06-06' + - subdomain: www.aistudio.google.com + first_seen: '2025-10-07' + last_seen: '2026-03-29' + - subdomain: google-public-dns-b.google.com + first_seen: '2025-10-06' + last_seen: '2026-03-29' + - subdomain: cse.sandbox.google.com + first_seen: '2025-10-12' + last_seen: '2026-03-29' + - subdomain: lti.workspace.google.com + first_seen: '2025-10-10' + last_seen: '2026-03-29' + - subdomain: cider.corp.google.com + first_seen: '2025-02-06' + last_seen: '2026-03-02' + - subdomain: c.play.google.com + first_seen: '2025-12-09' + last_seen: '2026-03-01' + - subdomain: us-east5.cloud.google.com + first_seen: '2025-11-27' + last_seen: '2026-06-06' + - subdomain: asia-southeast2.cloud.google.com + first_seen: '2025-11-21' + last_seen: '2026-06-06' + - subdomain: europe-west3.cloud.google.com + first_seen: '2025-11-28' + last_seen: '2026-06-06' + - subdomain: us-west4.cloud.google.com + first_seen: '2025-11-27' + last_seen: '2026-06-13' + - subdomain: asia-northeast2.cloud.google.com + first_seen: '2025-11-21' + last_seen: '2026-06-06' + - subdomain: europe-southwest1.cloud.google.com + first_seen: '2025-11-27' + last_seen: '2026-06-06' + - subdomain: me-west1.cloud.google.com + first_seen: '2025-11-27' + last_seen: '2026-06-06' + - subdomain: rr5---sn-nja7sner.c.drive.google.com + first_seen: '2025-06-13' + last_seen: '2026-05-24' + inactive_from: '2026-05-24' + - subdomain: europe-west6.cloud.google.com + first_seen: '2025-11-27' + last_seen: '2026-06-06' + - subdomain: tensorboard-staging.cloud.google.com + first_seen: '2025-10-27' + last_seen: '2026-06-06' + - subdomain: us-central1.cloud.google.com + first_seen: '2025-11-28' + last_seen: '2026-06-04' + - subdomain: lookerstudio.europe-north1.cloud.google.com + first_seen: '2025-02-26' + last_seen: '2026-06-08' + - subdomain: svc-1.google.com + first_seen: '2025-11-27' + last_seen: '2026-06-16' + - subdomain: lens.usercontent.google.com + first_seen: '2025-03-19' + last_seen: '2026-06-16' + - subdomain: works.url.google.com + first_seen: '2025-02-08' + last_seen: '2026-06-16' + - subdomain: bandwidth.voice.google.com + first_seen: '2025-07-07' + last_seen: '2026-06-06' + - subdomain: geminidataanalytics.cloud.google.com + first_seen: '2025-04-29' + last_seen: '2026-06-11' + - subdomain: pa.sandbox.google.com + first_seen: '2025-10-27' + last_seen: '2026-06-14' + - subdomain: lookerstudio.us-east1.cloud.google.com + first_seen: '2025-02-26' + last_seen: '2026-06-06' + - subdomain: lookerstudio.asia-south2.cloud.google.com + first_seen: '2025-02-26' + last_seen: '2026-06-08' + - subdomain: frame.ads-nightly.qa.adz.google.com + first_seen: '2025-12-01' + last_seen: '2026-05-25' + - subdomain: lookerstudio.me-central2.cloud.google.com + first_seen: '2025-02-26' + last_seen: '2026-06-14' + - subdomain: backupdr.cloud.google.com + first_seen: '2025-10-27' + last_seen: '2026-06-06' + - subdomain: rr2---sn-p5qlsnrr.c.drive.google.com + first_seen: '2025-02-16' + last_seen: '2026-06-05' + - subdomain: engineering.google.com + first_seen: '2025-03-06' + last_seen: '2025-10-26' + inactive_from: '2025-10-26' + - subdomain: lookerstudio.southamerica-west1.cloud.google.com + first_seen: '2025-02-26' + last_seen: '2026-06-13' + - subdomain: rr1---sn-gpv7kn7d.c.drive.google.com + first_seen: '2025-07-11' + last_seen: '2026-03-17' + - subdomain: us-central2.cloud-run-qual.mtls.sandbox.google.com + first_seen: '2025-05-12' + last_seen: '2026-03-17' + - subdomain: us-east4.cloud-run-qual.mtls.sandbox.google.com + first_seen: '2025-05-12' + last_seen: '2026-03-17' + - subdomain: frame.ads-prod.qa.adz.google.com + first_seen: '2025-12-01' + last_seen: '2026-04-03' + - subdomain: workflows.workspace.google.com + first_seen: '2025-08-05' + last_seen: '2026-03-30' + - subdomain: tensorboard.cloud.google.com + first_seen: '2025-10-27' + last_seen: '2026-06-06' + - subdomain: asia-east2.cloud.google.com + first_seen: '2025-11-21' + last_seen: '2026-06-06' + - subdomain: lookerstudio.europe-north2.cloud.google.com + first_seen: '2025-03-31' + last_seen: '2026-06-06' + - subdomain: r3---sn-vgqsknek.c.chat.google.com + first_seen: '2025-11-16' + last_seen: '2026-03-20' + - subdomain: dialogflow.clients6.google.com + first_seen: '2025-11-12' + last_seen: '2026-03-20' + - subdomain: reportcontent-prestaging.corp.google.com + first_seen: '2025-11-12' + last_seen: '2026-03-20' + - subdomain: frame.adwords-detours-prod.qa.adz.google.com + first_seen: '2025-12-01' + last_seen: '2026-04-03' + - subdomain: asia-northeast1.cloud.google.com + first_seen: '2025-11-27' + last_seen: '2026-06-04' + - subdomain: europe-north1.cloud.google.com + first_seen: '2025-11-27' + last_seen: '2026-06-08' + - subdomain: europe-central2.cloud.google.com + first_seen: '2025-11-27' + last_seen: '2026-06-08' + - subdomain: machinelearningtools-dev.cloud.google.com + first_seen: '2025-10-27' + last_seen: '2026-06-06' + - subdomain: access.workspace.google.com + first_seen: '2025-01-15' + last_seen: '2026-03-20' + - subdomain: gemini.usercontent.google.com + first_seen: '2025-11-28' + last_seen: '2026-06-08' + - subdomain: meet.usercontent.google.com + first_seen: '2025-11-28' + last_seen: '2026-06-08' + - subdomain: workspace.usercontent.google.com + first_seen: '2025-11-28' + last_seen: '2026-06-08' + - subdomain: southamerica-west1.cloud.google.com + first_seen: '2025-11-21' + last_seen: '2026-06-08' + - subdomain: northamerica-northeast2.cloud.google.com + first_seen: '2025-11-28' + last_seen: '2026-06-08' + - subdomain: composer-staging.cloud.google.com + first_seen: '2025-10-27' + last_seen: '2026-06-06' + - subdomain: composer.cloud.google.com + first_seen: '2025-10-27' + last_seen: '2026-06-06' + - subdomain: frame.searchads-canary.qa.adz.google.com + first_seen: '2025-12-01' + last_seen: '2026-04-03' + - subdomain: lookerstudio.me-west1.cloud.google.com + first_seen: '2025-02-26' + last_seen: '2026-06-06' + - subdomain: da-hot-6.da.ext.google.com + first_seen: '2025-04-01' + last_seen: '2026-03-17' + - subdomain: dataplex.cloud.google.com + first_seen: '2025-10-27' + last_seen: '2026-06-06' + - subdomain: frame.ds-next-devel.qa.adz.google.com + first_seen: '2025-12-01' + last_seen: '2026-04-03' + - subdomain: datafusion-api-dev.cloud.google.com + first_seen: '2025-10-27' + last_seen: '2026-06-06' + - subdomain: lookerstudio.us-central1.cloud.google.com + first_seen: '2025-02-26' + last_seen: '2026-06-07' + - subdomain: www-googletagmanager.l.google.com + first_seen: '2025-03-26' + last_seen: '2026-02-25' + - subdomain: telus.voice.google.com + first_seen: '2025-10-27' + last_seen: '2026-06-07' + - subdomain: lookerstudio.europe-central2.cloud.google.com + first_seen: '2025-02-26' + last_seen: '2026-06-09' + - subdomain: southamerica-east1.cloud.google.com + first_seen: '2025-11-27' + last_seen: '2026-06-08' + - subdomain: northamerica-south1.cloud.google.com + first_seen: '2025-11-27' + last_seen: '2026-06-06' + - subdomain: backupdr-dev.cloud.google.com + first_seen: '2025-10-27' + last_seen: '2026-06-06' + - subdomain: appsgrowthpromo-pa.clients6.google.com + first_seen: '2025-06-18' + last_seen: '2026-06-13' + - subdomain: us-west1.cloud-run-qual.mtls.sandbox.google.com + first_seen: '2025-05-12' + last_seen: '2026-03-17' + - subdomain: c.pack.google.com + first_seen: '2025-12-09' + last_seen: '2026-05-18' + - subdomain: europe-north2.cloud.google.com + first_seen: '2025-11-21' + last_seen: '2026-06-06' + - subdomain: us-west2.cloud.google.com + first_seen: '2025-11-21' + last_seen: '2026-06-10' + - subdomain: me-central1.cloud.google.com + first_seen: '2025-11-21' + last_seen: '2026-06-06' + - subdomain: us-south1.cloud.google.com + first_seen: '2025-12-02' + last_seen: '2026-06-04' + - subdomain: backupdr-staging.cloud.google.com + first_seen: '2025-10-27' + last_seen: '2026-06-06' + '400': + description: Bad Request – one or more parameters are invalid + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + examples: + InvalidParameters: {} + AfterDateError: {} + AfterDateGreaterThanCurrent: {} + BeforeDateGreaterThanCurrent: {} + '408': + description: Request Timeout – Unable to fetch WHOIS data + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:37:21.871Z' + status: 408 + error: Request Timeout + message: 'Unable to fetch whois data. Please try again. [For Technical Support email at: + support@whoisfreaks.com]' + path: /v1.0/subdomains/lookup + '503': + description: Service Unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + description: Timestamp of the error + path: + type: string + description: Request path + status: + type: integer + description: HTTP status code + error: + type: string + description: Error type + message: + type: string + description: Error message + example: + timestamp: '2025-08-14T10:37:02.237Z' + status: 503 + error: Service Unavailable + message: 'Service is unavailable. Please try after some time. [For Technical Support email + at: support@whoisfreaks.com]' + path: /v1.0/subdomains/lookup + operationId: getSubdomainsLookup + security: + - ApiKeyAuth: [] + /v1.0/geocoder/search: + get: + tags: + - Geocoding + summary: Forward geocoding (address to coordinates) + description: Convert a given address or place name into geographic coordinates (latitude and longitude). + parameters: + - name: query + in: query + required: true + schema: + type: string + description: Free-form search query, e.g. Wembley Stadium, London + - name: limit + in: query + required: false + schema: + type: integer + minimum: 1 + maximum: 40 + default: 1 + description: Max number of results to return (1–40). May return fewer if matches are weak. + - name: Accept-Language + in: header + required: false + schema: + type: string + description: Preferred language order for showing search results. This may either be a simple + comma-separated list of language codes or a single entry. The results will be in the 1st language + which is matched from the header. As a fallback if the results are not supported in the given + language, 'en' will be used. + - name: min_lat + in: query + required: false + schema: + type: number + format: float + minimum: -90 + maximum: 90 + description: Minimum latitude for the viewbox. Must be ≤ max_lat and between -90 and 90. + - name: max_lat + in: query + required: false + schema: + type: number + format: float + minimum: -90 + maximum: 90 + description: Maximum latitude for the viewbox. Must be ≥ min_lat and between -90 and 90. + - name: min_lon + in: query + required: false + schema: + type: number + format: float + minimum: -180 + maximum: 180 + description: Minimum longitude for the viewbox. Must be ≤ max_lon and between -180 and 180. + - name: max_lon + in: query + required: false + schema: + type: number + format: float + minimum: -180 + maximum: 180 + description: Maximum longitude for the viewbox. Must be ≥ min_lon and between -180 and 180. + responses: + '200': + description: Successful response + content: + application/json: + schema: + $ref: '#/components/schemas/GeocodingForwardGeocoderResponse' + example: + - lat: 48.8566 + lon: 2.3522 + name: Paris + category: place + type: city + street: Rue de Rivoli + area: Arrondissement 1 + postcode: '75001' + city: Paris + county: Paris + state_code: IDF + state: Île-de-France + country_code: FR + country: France + full_address: Rue de Rivoli, 75001 Paris, France + bounding_box: + - '48.8099' + - '48.9033' + - '2.2916' + - '2.4323' + poi: + - name: Eiffel Tower + category: amenity + type: attraction + '400': + description: Bad Request – one or more parameters are invalid + content: + application/json: + schema: + type: object + properties: + message: + type: string + description: Detailed error message + examples: + InvalidParameters: {} + InvalidLimit: {} + InvalidQueryString: {} + InvalidLatitude: {} + InvalidLongitude: {} + InvalidViewboxLatitude: {} + InvalidViewboxLongitude: {} + MissingViewboxParams: {} + '401': + description: Unauthorized + content: + application/json: + examples: + Unauthorized: {} + schema: + type: object + '404': + description: Not Found + content: + application/json: + examples: + ResultNotFound: {} + schema: + type: object + '500': + description: Internal Server Error + content: + application/json: + examples: + ServerError: {} + schema: + type: object + '504': + description: Gateway Timeout + content: + application/json: + examples: + Timeout: {} + schema: + type: object + security: + - ApiKeyAuth: [] + operationId: getGeocoderSearch + /v1.0/geocoder/reverse: + get: + tags: + - Geocoding + summary: Reverse geocoding (coordinates to address) + description: Convert geographic coordinates (latitude and longitude) into a human-readable address + or place name. + parameters: + - name: lat + in: query + required: true + schema: + type: number + format: float + description: WGS84 latitude value ranging from -90 to 90. + - name: lon + in: query + required: true + schema: + type: number + format: float + description: WGS84 longitude value ranging from -180 to 180. + - in: header + name: Accept-Language + required: false + schema: + type: string + description: Preferred language order for showing search results. This may either be a simple + comma-separated list of language codes or a single entry. The results will be in the 1st language + which is matched from the header. As a fallback if the results are not supported in the given + language, en will be used. + responses: + '200': + description: Successful response + content: + application/json: + schema: + $ref: '#/components/schemas/GeocodingReverseGeocoderResponse' + example: + lat: 40.7489669 + lon: -73.985399 + name: LensCrafters + category: shop + type: optician + poi: + - name: LensCrafters + category: shop + type: optician + - name: '7' + category: place + type: house_number + street: West 34th Street + area: Manhattan, New York County + postcode: '10001' + city: New York + state_code: US-NY + state: New York + country_code: US + country: United States + full_address: LensCrafters, 7, West 34th Street, Midtown South, Manhattan Community Board + 5, Manhattan, New York County, New York, 10001, United States + bounding_box: + - '40.7489169' + - '40.7490169' + - '-73.9854490' + - '-73.9853490' + '400': + description: Bad Request – one or more parameters are invalid + content: + application/json: + schema: + type: object + properties: + message: + type: string + description: Detailed error message + examples: + InvalidParameters: {} + InvalidLatitudeRange: {} + InvalidLongitudeRange: {} + InvalidLatitudeValue: {} + InvalidLongitudeValue: {} + '401': + description: Unauthorized + content: + application/json: + examples: + Unauthorized: {} + schema: + type: object + '404': + description: Not Found + content: + application/json: + examples: + ResultNotFound: {} + schema: + type: object + '500': + description: Internal Server Error + content: + application/json: + examples: + ServerError: {} + schema: + type: object + security: + - ApiKeyAuth: [] + operationId: getGeocoderReverse + /v1.0/geo/countries: + get: + tags: + - GeoDB + summary: Get list of countries + description: Retrieve countries, optionally filtered by region or subregion. + operationId: getCountries + parameters: + - name: format + in: query + description: Format of the response + required: false + schema: + type: string + enum: + - json + - xml + - name: region + in: query + description: Optional filter to return countries within a specific region from the region endpoint. + required: false + schema: + type: string + - name: subregion + in: query + description: Optional filter to return countries within a specific subregion from the subregion + endpoint. + required: false + schema: + type: string + responses: + '200': + description: Successful response with list of countries + content: + application/json: + schema: + $ref: '#/components/schemas/GeoDbCountries_Response' + '400': + description: Bad Request – Invalid parameters + content: + application/json: + examples: + InvalidRegion: + summary: Invalid region name + InvalidSubregion: + summary: Invalid subregion name + schema: + type: object + '401': + description: Unauthorized – Invalid or missing API key + content: + application/json: + examples: + InvalidApiKey: + summary: Invalid API Key + schema: + type: object + '404': + description: Not Found – No data found + content: + application/json: + examples: + NoDataFound: + summary: No data found + schema: + type: object + '500': + description: Internal Server Error + content: + application/json: + examples: + ServerError: + summary: Internal Server Error + schema: + type: object + security: + - ApiKeyAuth: [] + /v1.0/geo/country/details: + get: + tags: + - GeoDB + summary: Get GeoDB Country Details + operationId: getCountryDetails + parameters: + - name: format + in: query + description: Format of the response + required: false + schema: + type: string + enum: + - json + - xml + - name: country + in: query + required: true + description: Country code in ISO 3166-1 alpha-2 format. + schema: + type: string + responses: + '200': + description: Successful response with country details + content: + application/json: + schema: + $ref: '#/components/schemas/GeoDbCountry_Details_Response' + '400': + description: Invalid request due to incorrect country code format + content: + application/json: + examples: + InvalidCountryCode: + summary: Invalid Country Code + schema: + type: object + '401': + description: Unauthorized – Invalid or missing API key + content: + application/json: + examples: + InvalidApiKey: + summary: Invalid API Key + schema: + type: object + '404': + description: Not Found – Country not found + content: + application/json: + examples: + CountryNotFound: + summary: Country not found + schema: + type: object + '500': + description: Internal Server Error + content: + application/json: + examples: + ServerError: + summary: Internal Server Error + schema: + type: object + security: + - ApiKeyAuth: [] + /v1.0/geo/regions: + get: + tags: + - GeoDB + summary: Get GeoDB Regions + operationId: getGeoRegions + parameters: + - name: format + in: query + description: Format of the response + required: false + schema: + type: string + enum: + - json + - xml + responses: + '200': + description: Successful response with list of regions + content: + application/json: + schema: + type: object + properties: + regions: + type: array + items: + type: string + example: + - Africa + - Asia + - Europe + - North America + - South America + '400': + description: Bad Request – Invalid parameters + content: + application/json: + examples: + InvalidParam: + summary: Invalid parameter + schema: + type: object + '401': + description: Unauthorized - Invalid API Key + content: + application/json: + examples: + InvalidApiKey: + summary: Invalid API Key + schema: + type: object + '404': + description: Not Found – No data found + content: + application/json: + examples: + NoDataFound: + summary: No data found + schema: + type: object + '500': + description: Internal Server Error + content: + application/json: + examples: + ServerError: + summary: Internal Server Error + schema: + type: object + security: + - ApiKeyAuth: [] + /v1.0/geo/subregions: + get: + tags: + - GeoDB + summary: Get Subregions by Region + operationId: getSubregionsByRegion + parameters: + - name: format + in: query + description: Format of the response + required: false + schema: + type: string + enum: + - json + - xml + - name: region + in: query + required: true + description: Name of the region. + schema: + type: string + responses: + '200': + description: Successful response with list of subregions + content: + application/json: + schema: + type: object + properties: + subregions: + type: array + items: + type: string + example: + - Eastern Africa + - Western Europe + - Southern Asia + '401': + description: Unauthorized – Invalid or missing API key + content: + application/json: + examples: + InvalidApiKey: + summary: Invalid API Key + schema: + type: object + '400': + description: Invalid region name provided + content: + application/json: + examples: + InvalidRegion: + summary: Invalid region name + schema: + type: object + '404': + description: Resource not found + content: + application/json: + examples: + ResourceNotFound: + summary: Resource not found + schema: + type: object + '500': + description: Internal Server Error + content: + application/json: + examples: + ServerError: + summary: Internal Server Error + schema: + type: object + security: + - ApiKeyAuth: [] + /v1.0/geo/admin-levels: + get: + tags: + - GeoDB + summary: Get administrative units for a country + description: Retrieve administrative units based on ISO 3166-1 alpha-2 country code. + operationId: getAdminUnits + parameters: + - name: format + in: query + description: Format of the response + required: false + schema: + type: string + enum: + - json + - xml + - name: country + in: query + description: Country code in ISO 3166-1 alpha-2 format + required: true + schema: + type: string + security: + - ApiKeyAuth: [] + responses: + '200': + description: Successful response with list of administrative levels + content: + application/json: + schema: + $ref: '#/components/schemas/GeoDbAdmin_Level_Response' + '401': + description: Unauthorized – Invalid or missing API key + content: + application/json: + examples: + InvalidApiKey: + summary: Invalid API Key + schema: + type: object + '400': + description: Invalid request due to bad input + content: + application/json: + examples: + InvalidCountryCode: + summary: Invalid country code + schema: + type: object + '404': + description: No admin units found for the country + content: + application/json: + examples: + NoAdminUnits: + summary: No Admin Units + schema: + type: object + '500': + description: Internal Server Error + content: + application/json: + examples: + ServerError: + summary: Internal Server Error + schema: + type: object + /v1.0/geo/admin-units: + get: + tags: + - GeoDB + summary: Get Administrative Units by Country + description: Retrieve administrative divisions for a given country using ISO 3166-1 alpha-2 country + codes. You can optionally filter by administrative levels. + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - name: country + in: query + required: true + schema: + type: string + description: Country code in ISO 3166-1 alpha-2 format. + - name: adminLevels + in: query + required: false + schema: + type: array + items: + type: string + style: form + explode: false + description: Comma-separated list to filter results by one or more administrative levels. + responses: + '200': + description: Successful response with list of administrative units + content: + application/json: + schema: + $ref: '#/components/schemas/GeoDbAdmin_Units_Response' + '401': + description: Unauthorized – Invalid or missing API key + content: + application/json: + examples: + InvalidApiKey: + summary: Invalid API Key + schema: + type: object + '400': + description: Bad Request + content: + application/json: + examples: + InvalidRequest: + summary: Invalid Request + schema: + type: object + '404': + description: Not Found + content: + application/json: + examples: + NoAdminUnits: + summary: No Admin Units + schema: + type: object + '500': + description: Internal Server Error + content: + application/json: + examples: + ServerError: + summary: Internal Server Error + schema: + type: object + operationId: getGeoAdmin-units + security: + - ApiKeyAuth: [] + /v1.0/geo/admin-unit/details: + get: + summary: Get GeoDB Admin Unit Details + description: Retrieve detailed administrative unit information by country and optionally filtered + by admin code. + tags: + - GeoDB + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - name: country + in: query + required: true + schema: + type: string + description: Country code in ISO 3166-1 alpha-2 format. + - name: admin_unit + in: query + required: true + schema: + type: string + description: Optional admin code to fetch details for a specific administrative unit. + responses: + '200': + description: Successful response with admin unit details + content: + application/json: + schema: + $ref: '#/components/schemas/GeoDbAdmin_Unit_Details_Response' + '401': + description: Unauthorized – Invalid or missing API key + content: + application/json: + examples: + InvalidApiKey: + summary: Invalid API Key + schema: + type: object + '400': + description: Bad Request + content: + application/json: + examples: + InvalidCountryCode: + summary: Invalid Country Code + InvalidAdminCode: + summary: Invalid Admin Code + schema: + type: object + '404': + description: Not Found + content: + application/json: + examples: + NoAdminUnits: + summary: No Admin Units + schema: + type: object + '500': + description: Internal Server Error + content: + application/json: + examples: + ServerError: + summary: Internal Server Error + schema: + type: object + operationId: getGeoAdmin-unitDetails + security: + - ApiKeyAuth: [] + /v1.0/geo/cities: + get: + summary: Get Cities by Country and Admin Unit + description: Retrieve a list of cities within a country, optionally filtered by an administrative + unit code. + tags: + - GeoDB + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - name: country + in: query + required: true + schema: + type: string + description: Country code in ISO 3166-1 alpha-2 format. + - name: admin_unit + in: query + required: false + schema: + type: string + description: Administrative unit code used to filter cities within a specific region. + responses: + '200': + description: Successful response with list of cities + content: + application/json: + schema: + $ref: '#/components/schemas/GeoDbCities_Response' + '401': + description: Unauthorized – Invalid or missing API key + content: + application/json: + examples: + InvalidApiKey: + summary: Invalid API Key + schema: + type: object + '400': + description: Bad Request + content: + application/json: + examples: + InvalidCountryCode: + summary: Invalid Country Code + InvalidAdminCode: + summary: Invalid Admin Code + schema: + type: object + '404': + description: Not Found + content: + application/json: + examples: + NoAdminUnits: + summary: No Admin Units + schema: + type: object + '500': + description: Internal Server Error + content: + application/json: + examples: + ServerError: + summary: Internal Server Error + schema: + type: object + operationId: getGeoCities + security: + - ApiKeyAuth: [] + /v1.0/flags/supported: + get: + summary: Supported Flags + description: Get list of all supported flags with their metadata + tags: + - GeoDB + responses: + '200': + description: Successful response + content: + application/json: + schema: + type: array + items: + type: object + properties: + name: + type: string + iso2: + type: string + iso3: + type: string + required: + - name + - iso2 + - iso3 + operationId: getFlagsSupported + security: + - ApiKeyAuth: [] + /v1.0/flags: + get: + summary: Get Flag for Country + description: Retrieve the flag for a specific country + tags: + - GeoDB + parameters: + - name: name + in: query + required: true + schema: + type: string + description: Country code in ISO 3166-1 alpha-2 format. + - name: shape + in: query + required: true + schema: + type: string + enum: + - flat + - round + description: 'Flag shape. One of: `''flat''` or `''round''`.' + - name: format + in: query + required: false + schema: + type: string + enum: + - png + - webp + - svg + default: png + description: Flag format. Applicable only for PNG or WEBP formats. Default is png. + - name: size + in: query + required: false + schema: + type: string + enum: + - 16px + - 24px + - 32px + - 48px + - 64px + description: 'Flag size in pixels. Valid options: `16px`, `24px`, `32px`, `48px`, `64px`. Applicable + only for PNG or WEBP formats.' + - name: type + in: query + required: true + schema: + type: string + enum: + - country + - organization + description: 'Type of flag. One of: `country` or `organization`.' + responses: + '200': + description: Successful response + content: + image/png: + schema: + type: object + image/webp: + schema: + type: object + image/svg+xml: + schema: + type: object + '404': + content: + application/json: + examples: + InvalidCountry: {} + schema: + type: object + description: Response 404 + operationId: getFlags + security: + - ApiKeyAuth: [] + /v1.0/geolocation/lookup: + get: + tags: + - IP Geolocation + summary: Retrieve real-time and accurate IP geolocation and threat intelligence information for + an IPv4 or IPv6 address. + description: Get detailed IP geolocation data for an IP address including country, city, timezone, + currency, and optional threat intelligence and user-agent information + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - in: query + name: ip + schema: + type: string + description: IPv4, IPv6, or hostname for geolocation lookup + required: false + - in: query + name: lang + schema: + type: string + enum: + - en + - de + - ru + - ja + - fr + - cn + - es + - cs + - it + default: en + description: Response language for location fields + required: false + - in: query + name: fields + schema: + type: string + description: Comma separated list of fields to include in response + required: false + - in: query + name: excludes + schema: + type: string + description: Comma separated list of fields to exclude from response + required: false + - in: query + name: include + schema: + type: string + description: Additional data to include (location, network, security, currency, time_zone, user_agent, + country_metadata , hostname, liveHostname, hostnameFallbackLivet) + required: false + responses: + '200': + description: Successful response + content: + application/json: + schema: + $ref: '#/components/schemas/IpGeolocationGeolocationResponse' + '400': + description: Bad Request + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: The request was unacceptable. Typically due to missing or invalid parameters. + '404': + description: Not Found + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: Provided IP address '255.255.255.255' doesn't exist in our database. + examples: + Not found: {} + '423': + description: Locked + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: '''127.0.0.1'' is a bogon (Internet Assigned Numbers Authority) IP address.' + examples: + Bogon: {} + operationId: getGeolocationLookup + security: + - ApiKeyAuth: [] + post: + tags: + - IP Geolocation + summary: Retrieve geolocation information for multiple IP addresses in a single request. + description: 'Retrieve detailed geolocation data for multiple IP addresses in a single request. + + Supports up to `50,000` IP-addresses/host-names per request.' + operationId: bulkIpLookup + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - name: lang + in: query + required: false + schema: + type: string + default: en + description: Language of the response. + - name: fields + in: query + required: false + schema: + type: string + description: Comma-separated list of fields to include in the response. Can include "geo". + - name: excludes + in: query + required: false + schema: + type: string + description: Comma-separated list of fields to exclude from the response (except "ip"). + - name: include + in: query + required: false + schema: + type: string + description: Comma-separated list of additional information to include in the response. + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - ips + properties: + ips: + type: array + description: List of IP addresses or hostnames to lookup + maxItems: 50000 + items: + type: string + responses: + '200': + description: Successful response + content: + application/json: + schema: + $ref: '#/components/schemas/IpGeolocationBulkGeolocationResponse' + '400': + description: Bad Request + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: Please provide data in required format in request body + examples: + Invalid request parameters: {} + security: + - ApiKeyAuth: [] + /v1.0/ip/security: + get: + tags: + - IP Geolocation + summary: Retrieve security information for an IP address + description: Get comprehensive security information for a given IP address. Detects VPNs, proxies, + Tor nodes, and other security threats. + parameters: + - name: ip + in: query + required: false + schema: + type: string + description: A valid IPv4 or IPv6 address to look up. If omitted, the API uses the public IP of + the requesting client. + - name: fields + in: query + required: false + schema: + type: string + description: Comma-separated list of fields to return. Supports dot notation (e.g. security.threat_score). + - name: excludes + in: query + required: false + schema: + type: string + description: Comma-separated list of fields to remove from the response. Supports dot notation + (e.g. security.is_tor). + responses: + '200': + description: Successful response + content: + application/json: + schema: + $ref: '#/components/schemas/IpGeolocationIPSecurityResponse' + '400': + description: Bad Request + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: Provided IP address 'invalid' is not valid + examples: + Invalid request parameters: {} + '404': + description: Not Found + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: Provided IP address '999.999.999.999' is not valid + examples: + Not found: {} + '423': + description: '' + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: '''10.0.0.1'' is a bogon IP address.' + examples: + Bogon: {} + operationId: getIpSecurity + security: + - ApiKeyAuth: [] + post: + tags: + - IP Geolocation + summary: Retrieve security details for multiple IP addresses in a single request. + description: The Bulk IP Security Lookup API allows you to retrieve security details for up to `50,000` + IP-addresses in a single request. + operationId: bulkIpSecurityLookup + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - name: fields + in: query + required: false + schema: + type: string + description: Comma-separated list of fields to return. Supports dot notation (e.g. security.threat_score). + - name: excludes + in: query + required: false + schema: + type: string + description: Comma-separated list of fields to remove from the response. Supports dot notation + (e.g. security.is_tor). + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - ips + properties: + ips: + type: array + description: List of IP addresses to lookup + maxItems: 50000 + items: + type: string + responses: + '200': + description: Successful response + content: + application/json: + schema: + $ref: '#/components/schemas/IpGeolocationBulkIPSecurityResponse' + '400': + description: Bad Request + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: Please provide data in required format in request body + examples: + Invalid request parameters: {} + security: + - ApiKeyAuth: [] + /v1.0/geolocation/astronomy: + get: + tags: + - Astronomy + summary: Returns sunrise, sunset, moon phase, and celestial positions for a given location and date. + description: Retrieve sunrise and sunset times, current position of the moon, and other related + information by specifying a location address, location coordinates, IP address, or using the client + IP address if no parameter is passed. + parameters: + - name: format + in: query + required: false + schema: + type: string + default: json + enum: + - json + - xml + description: Format of the response. Can be "json" or "xml". + - in: query + name: location + schema: + type: string + default: New York, US + description: Extract astronomy information using location (preferably city) + required: false + - in: query + name: lat + schema: + type: number + format: float + description: Latitude to extract astronomy information using location coordinates + required: false + - in: query + name: long + schema: + type: number + format: float + description: Longitude to extract astronomy information using location coordinates + required: false + - in: query + name: ip + schema: + type: string + description: IPv4 or IPv6 address to extract astronomy information using IP address + required: false + - in: query + name: lang + schema: + type: string + default: en + enum: + - en + - de + - ru + - ja + - fr + - cn + - es + - cs + - it + - ko + - fa + - pt + description: Response language of "location" field in case of lookup through IP address only. + required: false + - in: query + name: date + schema: + type: string + format: date + description: Specific date (format YYYY-MM-DD) for which astronomy data is required + required: false + - in: query + name: elevation + schema: + type: number + format: float + default: 0 + description: Elevation above sea level at the location, in meters. The value should be between + 0 meter and a maximum value of 10,000 meters. Negative value is set to 0. + required: false + - in: query + name: time_zone + schema: + type: string + description: Time zone to receive all time-based data in your preferred local time. + required: false + responses: + '200': + description: Successful response with astronomy data + content: + application/json: + schema: + $ref: '#/components/schemas/OtherAstronomyResponse' + '400': + description: Bad Request – Invalid parameters provided + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: Latitude must be between -90 and 90. + examples: + Invalid Latitude or Longitude: {} + Invalid IP address: {} + Invalid Date format: {} + '404': + description: Not Found + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: We couldn't find the location (ZZZNOTEXIST). + examples: + Location Not Found: {} + operationId: getGeolocationAstronomy + security: + - ApiKeyAuth: [] + /v1.0/domain/ssl/live: + get: + tags: + - SSL + summary: Retrieve the SSL certificate and any hidden information embedded within it for a domain. + description: 'Retrieve comprehensive SSL certificate information without the certificate chain. + + This endpoint provides detailed information about the SSL certificate including expiry dates, + issuer details, and encryption methods. + + ' + operationId: sslCertificateLookup + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + example: json + - name: domainName + in: query + required: true + schema: + type: string + description: Domain name or URL whose SSL certificate lookup is required + example: google.com + - name: sslRaw + in: query + required: false + schema: + type: boolean + description: Set to true to get the raw openSSL response of the domain + example: true + responses: + '200': + description: Successful SSL certificate lookup response + content: + application/json: + schema: + $ref: '#/components/schemas/SslSSLLookupResponse' + examples: + Single SSL Certificate: {} + '400': + description: Bad Request – Invalid domain parameter + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + Invalid Domain Param: {} + '403': + description: Forbidden – Domain extension unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + Unavailable Domain Extension: {} + '404': + description: Not Found – No SSL certificate exists for entered domain + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + No SSL Certificate: {} + '503': + description: Service Unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + Service Unavailable: {} + '504': + description: Gateway Timeout – Request timed out + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + Request Timeout: {} + security: + - ApiKeyAuth: [] + /v1.0/domain/ssl/live/chain: + get: + tags: + - SSL + summary: Retrieve all certificates from the domain to the root Certificate Authority (CA) of a domain. + description: 'Retrieve the complete SSL certificate chain from root Certificate Authority (CA) to + end-user certificate. + + This endpoint provides comprehensive information about each certificate in the chain. + + ' + operationId: sslCertificateChainLookup + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + example: json + - name: domainName + in: query + required: true + schema: + type: string + description: Domain name or URL whose SSL certificate chain lookup is required + example: google.com + - name: sslRaw + in: query + required: false + schema: + type: boolean + description: Set to true to get the raw openSSL response for each certificate in the chain + example: true + responses: + '200': + description: Successful SSL certificate chain lookup response + content: + application/json: + schema: + $ref: '#/components/schemas/SslSSLLookupResponse' + examples: + SSL Certificate Chain: {} + '400': + description: Bad Request – Invalid domain parameter + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + Invalid Domain Param: {} + '403': + description: Forbidden – Domain extension unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + Unavailable Domain Extension: {} + '404': + description: Not Found – No SSL certificate exists + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + No SSL Certificate: {} + '503': + description: Service Unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + Service Unavailable: {} + '504': + description: Gateway Timeout – Request timed out + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + Request Timeout: {} + security: + - ApiKeyAuth: [] + /v1.0/geolocation/timezone: + get: + tags: + - Timezone + summary: Our API delivers a wide range of date and time information, including the current time, + date in multiple formats, week, month, year, and Unix timestamp. + description: Retrieve current time, date, and timezone-related information by specifying a timezone + name, location address, location coordinates, IP address, or use the client IP address if no parameter + is passed. + operationId: getTimezone + parameters: + - name: format + in: query + description: Format of the response + required: false + schema: + type: string + enum: + - json + - xml + - name: ip + in: query + description: IPv4 or IPv6 address to extract timezone information. + required: false + schema: + type: string + format: ipv4 + - name: tz + in: query + description: Timezone name (e.g., "Asia/Kolkata") to retrieve information directly. + required: false + schema: + type: string + - name: location + in: query + description: Location string (preferably city and country) to extract timezone. + required: false + schema: + type: string + - name: lat + in: query + description: Latitude for geolocation lookup. + required: false + schema: + type: number + format: float + - name: long + in: query + description: Longitude for geolocation lookup. + required: false + schema: + type: number + format: float + - name: lang + in: query + description: Language code for response localization (default is "en"). + required: false + schema: + type: string + default: en + - name: iata_code + in: query + description: 3-letter IATA airport code (e.g., JFK). + required: false + schema: + type: string + - name: icao_code + in: query + description: 4-letter ICAO airport code (e.g., KJFK). + required: false + schema: + type: string + - name: lo_code + in: query + description: 5-letter UN/LO city code. + required: false + schema: + type: string + responses: + '200': + description: Timezone lookup result + content: + application/json: + schema: + $ref: '#/components/schemas/TimezoneTimezoneResponse' + '400': + description: Bad Request – Invalid parameters provided + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: '''latitude'' (999) or ''longitude'' (0) is not valid.' + examples: + Invalid coordinates: {} + Invalid timezone name: {} + Invalid IP address: {} + Invalid IATA code: {} + Invalid ICAO code: {} + Invalid LO code: {} + '404': + description: Not Found + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: We couldn't find the location (ZZZNOTEXIST). + examples: + Location Not Found: {} + security: + - ApiKeyAuth: [] + /v1.0/timezone/converter: + get: + tags: + - Timezone + summary: Convert any timestamp from one timezone to another using timezone names, location coordinates, + or location addresses. + description: Converts a given time from one timezone to another using various input types like timezone + name, coordinates, location, or codes. + operationId: convertTimezone + parameters: + - name: format + in: query + description: Format of the response . + required: false + schema: + type: string + enum: + - json + - xml + - name: time + in: query + description: Time to convert in `yyyy-MM-dd HH:mm` or `yyyy-MM-dd HH:mm:ss` format. + required: false + schema: + type: string + - name: tz_from + in: query + description: Source timezone name (e.g., `Asia/Kolkata`). + required: false + schema: + type: string + - name: tz_to + in: query + description: Target timezone name (e.g., `America/New_York`). + required: false + schema: + type: string + - name: lat_from + in: query + description: Latitude of source location. + required: false + schema: + type: number + - name: long_from + in: query + description: Longitude of source location. + required: false + schema: + type: number + - name: lat_to + in: query + description: Latitude of target location. + required: false + schema: + type: number + - name: long_to + in: query + description: Longitude of target location. + required: false + schema: + type: number + - name: location_from + in: query + description: From location (city/country). + required: false + schema: + type: string + - name: location_to + in: query + description: To location (city/country). + required: false + schema: + type: string + - name: iata_from + in: query + description: From IATA airport code (e.g., JFK). + required: false + schema: + type: string + - name: iata_to + in: query + description: To IATA airport code. + required: false + schema: + type: string + - name: icao_from + in: query + description: From ICAO airport code (e.g., KJFK). + required: false + schema: + type: string + - name: icao_to + in: query + description: To ICAO airport code. + required: false + schema: + type: string + - name: locode_from + in: query + description: From UN/LO CODE. + required: false + schema: + type: string + - name: locode_to + in: query + description: To UN/LO CODE. + required: false + schema: + type: string + responses: + '200': + description: Successful response + content: + application/json: + schema: + $ref: '#/components/schemas/TimezoneTimezoneConversionResponse' + '400': + description: Bad Request – Invalid parameters provided + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: Parameters' combination is not complete. + examples: + Incomplete parameters combination: {} + Invalid source timezone: {} + Invalid coordinates range: {} + From location not found: {} + Invalid airport code: {} + security: + - ApiKeyAuth: [] + /v1.0/user-agent/lookup: + get: + tags: + - User Agent + summary: Obtain accurate browser, device, and operating system details by parsing a User Agent String. + description: Parse User Agent string to get detailed browser, device, and operating system information + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response + - in: header + name: User-Agent + required: true + schema: + type: string + description: The User-Agent string to parse. + responses: + '200': + description: Successful response with parsed user agent data + content: + application/json: + schema: + $ref: '#/components/schemas/UserAgentUserAgentParserResponse' + examples: + UserAgentParsed: {} + security: + - ApiKeyAuth: [] + operationId: getUser-agentLookup + post: + tags: + - User Agent + summary: Retrieve the browser, device, and operating system details of multiple user-agent strings + in a single request. + description: Parse up to `50,000 User-Agent strings` at once in a single request. + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + uaStrings: + type: array + items: + type: string + description: List of user agent strings to parse + maxItems: 100 + responses: + '200': + description: Successful response with parsed user agent data + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/UserAgentBulkUserAgentParserResponse' + examples: + BulkUserAgentParsed: {} + '400': + description: Bad Request – Invalid parameters provided + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: Please provide data in required format in request body + examples: + Invalid or missing request body: {} + Empty userAgentString: {} + operationId: postUser-agentLookup + security: + - ApiKeyAuth: [] + /v1.0/domain/whois/live: + get: + tags: + - WHOIS + summary: Retrieve the WHOIS Data for any domain + description: 'Retrieve current WHOIS information for a domain name. + + This endpoint provides detailed registration information including registrar details, + + dates, nameservers, and registrant information. + + ' + operationId: whoisLookup + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Response format (defaults to json) + - name: domainName + in: query + required: true + schema: + type: string + description: Domain name for WHOIS lookup + responses: + '200': + description: Successful response + content: + application/json: + schema: + $ref: '#/components/schemas/WhoisDomainWhoisLookupResponse' + example: + status: true + domain_name: google.com + query_time: '2026-06-18 06:42:34' + whois_server: https://rdap.verisign.com/com/v1/ + domain_registered: 'yes' + create_date: '1997-09-15' + update_date: '2024-08-02' + expiry_date: '2028-09-13' + domain_registrar: + iana_id: '292' + registrar_name: MarkMonitor Inc + whois_server: whois.markmonitor.com + website_url: https://www.markmonitor.com/ + email_address: abusecomplaints@markmonitor.com + phone_number: '+12086851750' + registrant_contact: + name: REDACTED REGISTRANT + company: Google LLC + street: REDACTED FOR PRIVACY + city: REDACTED FOR PRIVACY + zip_code: REDACTED FOR PRIVACY + country_name: United States + country_code: US + email_address: REDACTED FOR PRIVACY + phone: REDACTED FOR PRIVACY + name_servers: + - ns1.google.com + - ns2.google.com + - ns3.google.com + - ns4.google.com + domain_status: + - clientupdateprohibited + - clientdeleteprohibited + - clienttransferprohibited + - serverdeleteprohibited + - serverupdateprohibited + - servertransferprohibited + registry_data: + domain_name: google.com + query_time: '2026-06-18 06:42:33' + whois_server: https://rdap.verisign.com/com/v1/ + domain_registered: 'yes' + create_date: '1997-09-15' + update_date: '2019-09-09' + expiry_date: '2028-09-14' + domain_registrar: + iana_id: '292' + registrar_name: MarkMonitor Inc + whois_server: whois.markmonitor.com + name_servers: + - ns1.google.com + - ns2.google.com + - ns3.google.com + - ns4.google.com + domain_status: + - clientupdateprohibited + - clientdeleteprohibited + - clienttransferprohibited + - serverdeleteprohibited + - serverupdateprohibited + - servertransferprohibited + '403': + description: Forbidden – Access denied for the domain extension or inactive TLD + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + DomainExtensionNotSupported: {} + InactiveTLD: {} + '408': + description: Request Timeout – WHOIS data could not be fetched + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + WhoisTimeout: {} + '206': + description: Partial Content – The response contains partial data due to an error while processing + the request. + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + PartialContent: {} + '400': + description: Bad Request – Invalid domain name parameter + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + InvalidDomain: {} + '503': + description: Service Unavailable – Service is temporarily unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + ServiceUnavailable: {} + '504': + description: Request Timeout – Unable to fetch WHOIS data + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + RequestTimeout: {} + security: + - ApiKeyAuth: [] + post: + tags: + - WHOIS + summary: Retrieve WHOIS data of multiple domains in a single request + description: Retrieve WHOIS information for `100 Domains per Request`. + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - domainName + properties: + domainNames: + type: array + maxItems: 100 + items: + type: string + description: A list of domain names for which WHOIS data is requested. + responses: + '200': + description: WHOIS data retrieved successfully for all domains + content: + application/json: + schema: + $ref: '#/components/schemas/WhoisBulkWhoisLookupResponse' + example: + bulk_whois_response: + - status: true + domain_name: microsoft.com + query_time: '2026-06-18 07:33:14' + whois_server: https://rdap.verisign.com/com/v1/ + domain_registered: 'yes' + create_date: '1991-05-02' + update_date: '2026-01-29' + expiry_date: '2027-05-03' + domain_registrar: + iana_id: '292' + registrar_name: MarkMonitor Inc + whois_server: whois.markmonitor.com + website_url: https://www.markmonitor.com/ + email_address: abusecomplaints@markmonitor.com + phone_number: '+12086851750' + registrant_contact: + name: Domain Administrator + company: Microsoft Corporation + street: One Microsoft Way + city: Redmond + state: WA + zip_code: '98052' + country_name: United States + country_code: US + email_address: admin@domains.microsoft + phone: '+14258828080' + fax: '+14259367329' + technical_contact: + name: MSN Hostmaster + country_name: United States + country_code: US + email_address: msnhst@microsoft.com + phone: '+14258828080' + name_servers: + - ns4-39.azure-dns.info + - ns3-39.azure-dns.org + - ns1-39.azure-dns.com + - ns2-39.azure-dns.net + domain_status: + - clientupdateprohibited + - clientdeleteprohibited + - clienttransferprohibited + - serverdeleteprohibited + - serverupdateprohibited + - servertransferprohibited + registry_data: + domain_name: microsoft.com + query_time: '2026-06-18 07:33:13' + whois_server: https://rdap.verisign.com/com/v1/ + domain_registered: 'yes' + create_date: '1991-05-02' + update_date: '2026-01-29' + expiry_date: '2027-05-03' + domain_registrar: + iana_id: '292' + registrar_name: MarkMonitor Inc + whois_server: whois.markmonitor.com + name_servers: + - ns4-39.azure-dns.info + - ns3-39.azure-dns.org + - ns1-39.azure-dns.com + - ns2-39.azure-dns.net + domain_status: + - clientupdateprohibited + - clientdeleteprohibited + - clienttransferprohibited + - serverdeleteprohibited + - serverupdateprohibited + - servertransferprohibited + '400': + description: Bad Request – Invalid domain name parameters + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + InvalidParamException: {} + '403': + description: Forbidden – Invalid API key or unauthorized request + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + Forbidden: {} + '206': + description: Partial Content – The response contains partial data due to an error while processing + the request. + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + PartialContent: {} + '503': + description: Service Unavailable – Service is temporarily unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + ServiceUnavailable: {} + '504': + description: Request Timeout – Unable to fetch WHOIS data + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + RequestTimeout: {} + operationId: postDomainWhoisLive + security: + - ApiKeyAuth: [] + /v1.0/ip/whois/live: + get: + tags: + - WHOIS + summary: Access the WHOIS Data for any IP + description: Returns WHOIS registration details for a specified IP address (IPv4 or IPv6). + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - name: ip + in: query + required: true + schema: + type: string + description: The IP address (IPv4 or IPv6) for which WHOIS data is requested. + responses: + '200': + description: Successful response + content: + application/json: + schema: + $ref: '#/components/schemas/WhoisIpWhoisResponse' + example: + status: true + ip_address: 8.8.8.8 + query_time: '2026-06-05 15:33:44' + whois_server: whois.arin.net + inet_nums: + - start_ip: 8.8.8.0 + end_ip: 8.8.8.255 + cidr: + - 8.8.8.0/24 + net_name: GOGL + net_handle: NET-8-8-8-0-2 + status: Direct Allocation + organization: Google LLC (GOGL) + date_created: '2023-12-28' + date_updated: '2023-12-28' + source: https://rdap.arin.net/registry/ip/8.8.8.0 + parents: + - NET8 (NET-8-0-0-0-0) + organization: + handle: GOGL + name: Google LLC + address: + - 1600 Amphitheatre Parkway + - Mountain View + - CA + - '94043' + - US + street: Amphitheatre Parkway + city: Mountain View + state: CA + zip_code: '94043' + country: + - US + date_created: '2000-03-30' + date_updated: '2019-10-31' + source: https://rdap.arin.net/registry/entity/GOGL + technical_contacts: + - handle: ZG39-ARIN + name: Google LLC + email: + - arin-contact@google.com + phone: + - +1-650-253-0000 + source: https://rdap.arin.net/registry/entity/ZG39-ARIN + abuse_contacts: + - handle: ABUSE5250-ARIN + name: Abuse + email: + - network-abuse@google.com + phone: + - +1-650-253-0000 + source: https://rdap.arin.net/registry/entity/ABUSE5250-ARIN + routes: + - source: https://rdap.arin.net/registry/ip/8.8.8.0 + whois_raw_response: '...' + '400': + description: Bad Request – Invalid IP address parameter + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + InvalidIpParam: {} + '206': + description: Partial Content – Partial response due to an error occurred while processing the + request. + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + PartialResponse: {} + '503': + description: Service Unavailable – Service is temporarily unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + ServiceUnavailable: {} + '504': + description: Request Timeout – Unable to fetch WHOIS data + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + RequestTimeout: {} + operationId: getIpWhoisLive + security: + - ApiKeyAuth: [] + /v1.0/asn/whois/live: + get: + tags: + - WHOIS + summary: Get detailed ASN information, including block ranges, routing policies, contacts, and both + structured and raw WHOIS data for any ASN. + description: Returns WHOIS registration details for a specified ASN, with or without the 'as' prefix. + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - name: asn + in: query + required: true + schema: + type: string + description: The Autonomous System Number (ASN) to retrieve WHOIS data for. Can be prefixed with + 'as' or not. + responses: + '200': + description: Successful response + content: + application/json: + schema: + $ref: '#/components/schemas/WhoisASNLookupResponse' + example: + asNumber: '15' + asName: NET-DYNAMICS-EXP + orgName: DYNAMICS + description: '' + orgHandle: dynami-109 + country: US + domain: nisc.sri.com + website: '' + allocationStatus: '' + numOfIPv4Routes: '0' + numOfIPv6Routes: '0' + whoisHost: ARIN + dateAllocated: '' + type: ISP + routeObjects: [] + whoisResponse: 'ASNumber: 15 + + ASName: NET-DYNAMICS-EXP + + ASHandle: AS15 + + Updated: 1991-06-27 + + OrgName: DYNAMICS + + OrgId: DYNAMI-109' + downstreams: [] + parsedWhoisResponse: + status: true + whois_server: whois.arin.net + aut_nums: + - aut_num: '15' + as_handle: AS15 + as_name: NET-DYNAMICS-EXP + tech_contacts: + - ZSU-ARIN + - ZSU-ARIN + abuse_contacts: + - ZSU-ARIN + date_updated: '1991-06-27' + source: https://rdap.arin.net/registry/autnum/15 + organization: + handle: DYNAMI-109 + name: DYNAMICS + address: + - US + country: + - US + date_updated: '2012-10-10' + source: https://rdap.arin.net/registry/entity/DYNAMI-109 + addressCountry: US + technical_contacts: + - handle: ZSU-ARIN + name: Su, Zaw-Sing + email: + - zsu@nisc.sri.com + phone: + - +1-415-859-4576 + source: https://rdap.arin.net/registry/entity/ZSU-ARIN + abuse_contacts: + - handle: ZSU-ARIN + name: Su, Zaw-Sing + email: + - zsu@nisc.sri.com + phone: + - +1-415-859-4576 + source: https://rdap.arin.net/registry/entity/ZSU-ARIN + upstreams: [] + peers: [] + contacts: + emailContacts: + - zsu@nisc.sri.com + abuseContacts: [] + legacyRoutes: [] + '400': + description: Bad Request – Invalid ASN parameter + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + InvalidASNParameter: {} + '206': + description: Partial Content – Partial response, as an error occurred while processing the request. + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + PartialResponse: {} + '503': + description: Service Unavailable – Service is temporarily unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + ServiceUnavailable: {} + '504': + description: Request Timeout – Unable to fetch WHOIS data + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + RequestTimeout: {} + operationId: getAsnWhoisLive + security: + - ApiKeyAuth: [] + /v1.0/domain/whois/history: + get: + tags: + - WHOIS + summary: Get all the historical WHOIS records of a domain + description: 'Retrieve historical WHOIS records for a domain name. + + This endpoint provides a timeline of all recorded changes in domain registration information. + + ' + operationId: whoisHistoryLookup + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - name: domainName + in: query + required: true + schema: + type: string + description: Domain name for historical WHOIS lookup + responses: + '200': + description: Successful response + content: + application/json: + schema: + $ref: '#/components/schemas/WhoisDomainWHOISHistoricalLookupResponse' + example: + status: true + whois: historical + total_records: '18' + whois_domains_historical: + - num: 1 + status: true + domain_name: example.com + query_time: '2022-04-28 12:56:13' + create_date: '1992-01-01' + update_date: '2021-08-14' + expiry_date: '2022-08-13' + - num: 18 + status: true + domain_name: example.com + query_time: '2026-06-18 07:17:18' + whois_server: https://rdap.verisign.com/com/v1/ + domain_registered: 'yes' + create_date: '1992-01-01' + update_date: '2026-01-16' + expiry_date: '2026-08-13' + name_servers: + - elliott.ns.cloudflare.com + - hera.ns.cloudflare.com + registry_data: + domain_name: EXAMPLE.COM + query_time: '2026-06-18 07:17:16' + whois_server: whois.verisign-grs.com + domain_registered: 'yes' + create_date: '1995-08-14' + update_date: '2026-01-16' + expiry_date: '2026-08-13' + domain_registrar: + iana_id: '376' + registrar_name: RESERVED-Internet Assigned Numbers Authority + whois_server: whois.iana.org + website_url: http://res-dom.iana.org + name_servers: + - elliott.ns.cloudflare.com + - hera.ns.cloudflare.com + domain_status: + - clientupdateprohibited + - clientdeleteprohibited + - clienttransferprohibited + '400': + description: Bad Request – Invalid domain name parameter + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + InvalidDomainParam: {} + '404': + description: Not Found – No record found for the domain + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + RecordNotFound: {} + '503': + description: Service Unavailable – Service is temporarily unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + ServiceUnavailable: {} + '504': + description: Request Timeout – Unable to fetch WHOIS data + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + RequestTimeout: {} + security: + - ApiKeyAuth: [] + /v1.0/domain/whois/reverse: + get: + tags: + - WHOIS + summary: Get all the domains registered by a particular company or owner, or access the domains + with specific keywords in their domain names + description: Performs a reverse WHOIS search using one or more search parameters like keyword, email, + owner, or company. + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - name: keyword + in: query + required: false + schema: + type: string + description: Keyword search term for reverse WHOIS by keyword (case-insensitive pattern matching). + - name: email + in: query + required: false + schema: + type: string + description: Email search term for reverse WHOIS by email address (case-insensitive exact or regex + match; * wildcard supported). + - name: owner + in: query + required: false + schema: + type: string + description: Registrant or owner name for reverse WHOIS (a full-text search phrase matching technique + to retrieve results). + - name: company + in: query + required: false + schema: + type: string + description: Organization or company name for reverse WHOIS (full-text search phrase matching + technique to retrieve results). + - name: exact + in: query + required: false + schema: + type: boolean + default: false + description: Accepts 'true' or 'false'. "true" returns only records that exactly match the input + (keyword, owner/registrant, or company). "false" returns all matches and is the default when + omitted. + - name: mode + in: query + required: false + schema: + type: string + enum: + - default + - mini + default: default + description: '"default" for Complete WHOIS data and "mini" for Only important fields of each matching + domain.' + - name: page + in: query + required: false + schema: + type: integer + default: 1 + description: Page number for paginated results. + responses: + '200': + description: Successful response + content: + application/json: + schema: + type: object + properties: + total_Result: + type: integer + total_Pages: + type: integer + current_Page: + type: integer + whois_domains_historical: + type: array + items: + oneOf: + - $ref: '#/components/schemas/WhoisHistoricalWHOISDefault' + - $ref: '#/components/schemas/WhoisHistoricalWHOISMini' + example: + total_Result: 8 + total_Pages: 1 + current_Page: 1 + whois_domains_historical: + - num: 1 + status: true + domain_name: ipgeolocationdatabase.com + query_time: '2026-05-21 04:00:28' + create_date: '2010-04-14' + update_date: '2026-05-19' + expiry_date: '2027-04-14' + domain_registrar: + iana_id: '269' + registrar_name: Key-Systems GmbH + whois_server: whois.rrpproxy.net + website_url: http://www.key-systems.net + email_address: abuse@key-systems.net + phone_number: '+4968949396850' + registrant_contact: + id: Not Available From Registry + name: On behalf of ipgeolocationdatabase.com OWNER + company: c/o whoisproxy.com + city: Alexandria + state: VA + zip_code: '22314' + country_name: United States + country_code: US + email_address: 720ed14de67db24c4eb07295ecae369f9f1bfe8a4dd5cd0c51f0e4754ee24895@ipgeolocationdatabase.com.whoisproxy.org + phone: '+6448319528' + name_servers: + - dale.ns.cloudflare.com + - olga.ns.cloudflare.com + domain_status: + - clienttransferprohibited + '400': + description: Bad Request – Required parameter value is missing + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + MissingParam: {} + '404': + description: Not Found – No matching record found + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + RecordNotFound: {} + '504': + description: Request Timeout – Unable to fetch WHOIS data + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + RequestTimeout: {} + '503': + description: Service Unavailable – Service is temporarily unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + ServiceUnavailable: {} + operationId: getDomainWhoisReverse + security: + - ApiKeyAuth: [] + /v2.0/geolocation/timezone: + get: + tags: + - Timezone + summary: Timezone lookup (v2.0) + description: Retrieve current time, date, and timezone-related information by specifying a timezone + name, location address, location coordinates, IP address, or use the client IP address if no parameter + is passed. - v2.0 response format. + operationId: getTimezoneV2 + parameters: + - name: format + in: query + description: Format of the response + required: false + schema: + type: string + enum: + - json + - xml + - name: ip + in: query + description: IPv4 or IPv6 address to extract timezone information. + required: false + schema: + type: string + format: ipv4 + - name: tz + in: query + description: Timezone name (e.g., "Asia/Kolkata") to retrieve information directly. + required: false + schema: + type: string + - name: location + in: query + description: Location string (preferably city and country) to extract timezone. + required: false + schema: + type: string + - name: lat + in: query + description: Latitude for geolocation lookup. + required: false + schema: + type: number + format: float + - name: long + in: query + description: Longitude for geolocation lookup. + required: false + schema: + type: number + format: float + - name: lang + in: query + description: Language code for response localization (default is "en"). + required: false + schema: + type: string + default: en + enum: + - en + - de + - ru + - ja + - fr + - cn + - es + - cs + - it + - ko + - fa + - pt + - name: iata_code + in: query + description: 3-letter IATA airport code (e.g., JFK). + required: false + schema: + type: string + - name: icao_code + in: query + description: 4-letter ICAO airport code (e.g., KJFK). + required: false + schema: + type: string + - name: lo_code + in: query + description: 5-letter UN/LO city code. + required: false + schema: + type: string + responses: + '200': + description: Timezone lookup result + content: + application/json: + schema: + $ref: '#/components/schemas/TimezoneTimezoneResponse' + '400': + description: Bad Request – Invalid parameters provided + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: '''latitude'' (999) or ''longitude'' (0) is not valid.' + examples: + Invalid coordinates: {} + Invalid timezone name: {} + Invalid IP address: {} + Invalid IATA code: {} + Invalid ICAO code: {} + Invalid LO code: {} + '404': + description: Not Found + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: We couldn't find the location (ZZZNOTEXIST). + examples: + Location Not Found: {} + security: + - ApiKeyAuth: [] + /v2.0/geolocation/astronomy: + get: + tags: + - Astronomy + summary: Astronomy lookup (v2.0) + description: Retrieve sunrise and sunset times, current position of the moon, and other related + information by specifying a location address, location coordinates, IP address, or using the client + IP address if no parameter is passed. - v2.0 response format. + parameters: + - name: format + in: query + required: false + schema: + type: string + default: json + enum: + - json + - xml + description: Format of the response. Can be "json" or "xml". + - in: query + name: location + schema: + type: string + default: New York, US + description: Extract astronomy information using location (preferably city) + required: false + - in: query + name: lat + schema: + type: number + format: float + description: Latitude to extract astronomy information using location coordinates + required: false + - in: query + name: long + schema: + type: number + format: float + description: Longitude to extract astronomy information using location coordinates + required: false + - in: query + name: ip + schema: + type: string + description: IPv4 or IPv6 address to extract astronomy information using IP address + required: false + - in: query + name: lang + schema: + type: string + default: en + enum: + - en + - de + - ru + - ja + - fr + - cn + - es + - cs + - it + - ko + - fa + - pt + description: Response language of "location" field in case of lookup through IP address only. + required: false + - in: query + name: date + schema: + type: string + format: date + description: Specific date (format YYYY-MM-DD) for which astronomy data is required + required: false + - in: query + name: elevation + schema: + type: number + format: float + default: 0 + description: Elevation above sea level at the location, in meters. The value should be between + 0 meter and a maximum value of 10,000 meters. Negative value is set to 0. + required: false + - in: query + name: time_zone + schema: + type: string + description: Time zone to receive all time-based data in your preferred local time. + required: false + responses: + '200': + description: Successful response with astronomy data + content: + application/json: + schema: + $ref: '#/components/schemas/OtherAstronomyResponse' + '400': + description: Bad Request – Invalid parameters provided + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: Latitude must be between -90 and 90. + examples: + Invalid Latitude or Longitude: {} + Invalid IP address: {} + Invalid Date format: {} + '404': + description: Not Found + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: We couldn't find the location (ZZZNOTEXIST). + examples: + Location Not Found: {} + operationId: getGeolocationAstronomyV2 + security: + - ApiKeyAuth: [] + /v2.0/geolocation/lookup: + get: + tags: + - IP Geolocation + summary: IP geolocation lookup (v2.0) + description: Get detailed IP geolocation data for an IP address including country, city, timezone, + currency, and optional threat intelligence and user-agent information - v2.0 response format. + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - in: query + name: ip + schema: + type: string + description: IPv4, IPv6, or hostname for geolocation lookup + required: false + - in: query + name: lang + schema: + type: string + enum: + - en + - de + - ru + - ja + - fr + - cn + - es + - cs + - it + - ko + - fa + - pt + default: en + description: Response language for location fields + required: false + - in: query + name: fields + schema: + type: string + description: Comma separated list of fields to include in response + required: false + - in: query + name: excludes + schema: + type: string + description: Comma separated list of fields to exclude from response + required: false + - in: query + name: include + schema: + type: string + description: Additional data to include (location, network, security, currency, time_zone, user_agent, + country_metadata , hostname, liveHostname, hostnameFallbackLivet) + required: false + responses: + '200': + description: Successful response + content: + application/json: + schema: + $ref: '#/components/schemas/IpGeolocationGeolocationResponse' + '400': + description: Bad Request + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: The request was unacceptable. Typically due to missing or invalid parameters. + '404': + description: Not Found + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: Provided IP address '255.255.255.255' doesn't exist in our database. + examples: + Not found: {} + '423': + description: Locked + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: '''127.0.0.1'' is a bogon (Internet Assigned Numbers Authority) IP address.' + examples: + Bogon: {} + operationId: getGeolocationLookupV2 + security: + - ApiKeyAuth: [] + post: + tags: + - IP Geolocation + summary: Bulk IP geolocation lookup (v2.0) + description: 'Retrieve detailed geolocation data for multiple IP addresses in a single request. + + Supports up to `50,000` IP-addresses/host-names per request. - v2.0 response format.' + operationId: bulkIpLookupV2 + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + - name: lang + in: query + required: false + schema: + type: string + default: en + enum: + - en + - de + - ru + - ja + - fr + - cn + - es + - cs + - it + - ko + - fa + - pt + description: Language of the response. + - name: fields + in: query + required: false + schema: + type: string + description: Comma-separated list of fields to include in the response. Can include "geo". + - name: excludes + in: query + required: false + schema: + type: string + description: Comma-separated list of fields to exclude from the response (except "ip"). + - name: include + in: query + required: false + schema: + type: string + description: Comma-separated list of additional information to include in the response. + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - ips + properties: + ips: + type: array + description: List of IP addresses or hostnames to lookup + maxItems: 50000 + items: + type: string + responses: + '200': + description: Successful response + content: + application/json: + schema: + $ref: '#/components/schemas/IpGeolocationBulkGeolocationResponse' + '400': + description: Bad Request + content: + application/json: + schema: + type: object + properties: + message: + type: string + example: Please provide data in required format in request body + examples: + Invalid request parameters: {} + security: + - ApiKeyAuth: [] + /v2.0/domain/whois/live: + get: + tags: + - WHOIS + summary: Domain WHOIS lookup (v2.0) + description: 'Retrieve current WHOIS information for a domain name. + + This endpoint provides detailed registration information including registrar details, + + dates, nameservers, and registrant information. - v2.0 response format.' + operationId: whoisLookupV2 + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Response format (defaults to json) + - name: domainName + in: query + required: true + schema: + type: string + description: Domain name for WHOIS lookup + responses: + '200': + description: Successful response + content: + application/json: + schema: + $ref: '#/components/schemas/WhoisDomainWhoisLookupResponse' + example: + status: true + domain_name: google.com + query_time: '2026-06-18 06:42:34' + whois_server: https://rdap.verisign.com/com/v1/ + domain_registered: 'yes' + create_date: '1997-09-15' + update_date: '2024-08-02' + expiry_date: '2028-09-13' + domain_registrar: + iana_id: '292' + registrar_name: MarkMonitor Inc + whois_server: whois.markmonitor.com + website_url: https://www.markmonitor.com/ + email_address: abusecomplaints@markmonitor.com + phone_number: '+12086851750' + registrant_contact: + name: REDACTED REGISTRANT + company: Google LLC + street: REDACTED FOR PRIVACY + city: REDACTED FOR PRIVACY + zip_code: REDACTED FOR PRIVACY + country_name: United States + country_code: US + email_address: REDACTED FOR PRIVACY + phone: REDACTED FOR PRIVACY + name_servers: + - ns1.google.com + - ns2.google.com + - ns3.google.com + - ns4.google.com + domain_status: + - clientupdateprohibited + - clientdeleteprohibited + - clienttransferprohibited + - serverdeleteprohibited + - serverupdateprohibited + - servertransferprohibited + registry_data: + domain_name: google.com + query_time: '2026-06-18 06:42:33' + whois_server: https://rdap.verisign.com/com/v1/ + domain_registered: 'yes' + create_date: '1997-09-15' + update_date: '2019-09-09' + expiry_date: '2028-09-14' + domain_registrar: + iana_id: '292' + registrar_name: MarkMonitor Inc + whois_server: whois.markmonitor.com + name_servers: + - ns1.google.com + - ns2.google.com + - ns3.google.com + - ns4.google.com + domain_status: + - clientupdateprohibited + - clientdeleteprohibited + - clienttransferprohibited + - serverdeleteprohibited + - serverupdateprohibited + - servertransferprohibited + '403': + description: Forbidden – Access denied for the domain extension or inactive TLD + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + DomainExtensionNotSupported: {} + InactiveTLD: {} + '408': + description: Request Timeout – WHOIS data could not be fetched + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + WhoisTimeout: {} + '206': + description: Partial Content – The response contains partial data due to an error while processing + the request. + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + PartialContent: {} + '400': + description: Bad Request – Invalid domain name parameter + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + InvalidDomain: {} + '503': + description: Service Unavailable – Service is temporarily unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + ServiceUnavailable: {} + '504': + description: Request Timeout – Unable to fetch WHOIS data + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + RequestTimeout: {} + security: + - ApiKeyAuth: [] + post: + tags: + - WHOIS + summary: Bulk domain WHOIS lookup (v2.0) + description: Retrieve WHOIS information for `100 Domains per Request`. - v2.0 response format. + parameters: + - name: format + in: query + required: false + schema: + type: string + enum: + - json + - xml + description: Format of the response. + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - domainName + properties: + domainNames: + type: array + maxItems: 100 + items: + type: string + description: A list of domain names for which WHOIS data is requested. + responses: + '200': + description: WHOIS data retrieved successfully for all domains + content: + application/json: + schema: + $ref: '#/components/schemas/WhoisBulkWhoisLookupResponse' + example: + bulk_whois_response: + - status: true + domain_name: microsoft.com + query_time: '2026-06-18 07:33:14' + whois_server: https://rdap.verisign.com/com/v1/ + domain_registered: 'yes' + create_date: '1991-05-02' + update_date: '2026-01-29' + expiry_date: '2027-05-03' + domain_registrar: + iana_id: '292' + registrar_name: MarkMonitor Inc + whois_server: whois.markmonitor.com + website_url: https://www.markmonitor.com/ + email_address: abusecomplaints@markmonitor.com + phone_number: '+12086851750' + registrant_contact: + name: Domain Administrator + company: Microsoft Corporation + street: One Microsoft Way + city: Redmond + state: WA + zip_code: '98052' + country_name: United States + country_code: US + email_address: admin@domains.microsoft + phone: '+14258828080' + fax: '+14259367329' + technical_contact: + name: MSN Hostmaster + country_name: United States + country_code: US + email_address: msnhst@microsoft.com + phone: '+14258828080' + name_servers: + - ns4-39.azure-dns.info + - ns3-39.azure-dns.org + - ns1-39.azure-dns.com + - ns2-39.azure-dns.net + domain_status: + - clientupdateprohibited + - clientdeleteprohibited + - clienttransferprohibited + - serverdeleteprohibited + - serverupdateprohibited + - servertransferprohibited + registry_data: + domain_name: microsoft.com + query_time: '2026-06-18 07:33:13' + whois_server: https://rdap.verisign.com/com/v1/ + domain_registered: 'yes' + create_date: '1991-05-02' + update_date: '2026-01-29' + expiry_date: '2027-05-03' + domain_registrar: + iana_id: '292' + registrar_name: MarkMonitor Inc + whois_server: whois.markmonitor.com + name_servers: + - ns4-39.azure-dns.info + - ns3-39.azure-dns.org + - ns1-39.azure-dns.com + - ns2-39.azure-dns.net + domain_status: + - clientupdateprohibited + - clientdeleteprohibited + - clienttransferprohibited + - serverdeleteprohibited + - serverupdateprohibited + - servertransferprohibited + '400': + description: Bad Request – Invalid domain name parameters + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + InvalidParamException: {} + '403': + description: Forbidden – Invalid API key or unauthorized request + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + Forbidden: {} + '206': + description: Partial Content – The response contains partial data due to an error while processing + the request. + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + PartialContent: {} + '503': + description: Service Unavailable – Service is temporarily unavailable + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + ServiceUnavailable: {} + '504': + description: Request Timeout – Unable to fetch WHOIS data + content: + application/json: + schema: + type: object + properties: + timestamp: + type: string + format: date-time + example: '2025-08-14T09:25:32.271Z' + status: + type: integer + error: + type: string + message: + type: string + path: + type: string + examples: + RequestTimeout: {} + operationId: postDomainWhoisLiveV2 + security: + - ApiKeyAuth: [] +components: + securitySchemes: + ApiKeyAuth: + type: apiKey + in: header + name: X-apiKey + schemas: + DnsAorAAAARecord: + type: object + required: + - name + - type + - dnsType + - ttl + - rawText + - rRsetType + - address + properties: + name: + type: string + description: Name of the queried domain + type: + type: integer + description: DNS type code (e.g., 1 for A, 28 for AAAA) + dnsType: + type: string + enum: + - A + - AAAA + description: DNS type as a string (e.g., "A", "AAAA") + ttl: + type: integer + description: Time to live in seconds + rawText: + type: string + description: Raw (un-parsed) DNS record text + rRsetType: + type: integer + description: Indicates the resource record set type + address: + type: string + description: IPv4 or IPv6 address for A or AAAA records respectively + title: A / AAAA Record + DnsBulkDNSLookupResponse: + type: object + required: + - bulk_dns_info + properties: + bulk_dns_info: + type: array + items: + type: object + properties: + status: + type: boolean + description: Indicates whether the query was processed successfully + queryTime: + type: string + description: 'Time at which the query was made (Format: YYYY-MM-DD HH:mm:ss)' + domainName: + type: string + description: Queried domain (present for domain lookups) + domainRegistered: + type: boolean + description: Indicates whether the domain is registered (present for domain lookups) + ipAddress: + type: string + description: IP address queried (present for IP lookups) + dnsTypes: + type: object + properties: + A: + type: number + AAAA: + type: number + MX: + type: number + NS: + type: number + SOA: + type: number + TXT: + type: number + SPF: + type: number + PTR: + type: number + dnsRecords: + type: array + items: + oneOf: + - $ref: '#/components/schemas/DnsAorAAAARecord' + - $ref: '#/components/schemas/DnsCNAMERecord' + - $ref: '#/components/schemas/DnsMXRecord' + - $ref: '#/components/schemas/DnsNSRecord' + - $ref: '#/components/schemas/DnsSOARecord' + - $ref: '#/components/schemas/DnsTXTRecord' + DnsCNAMERecord: + type: object + required: + - name + - type + - dnsType + - ttl + - rawText + - rRsetType + - target + properties: + name: + type: string + description: Name of the queried domain + type: + type: integer + description: DNS type code (5 for CNAME) + dnsType: + type: string + enum: + - CNAME + description: DNS type as a string ("CNAME") + ttl: + type: integer + description: Time to live in seconds + rawText: + type: string + description: Raw (un-parsed) DNS record text + rRsetType: + type: integer + description: Indicates the resource record set type + target: + type: string + description: Host to which this domain points + title: CNAME Record + DnsDNSLookupResponse: + type: object + required: + - status + - queryTime + - domainName + - domainRegistered + - dnsTypes + - dnsRecords + properties: + status: + type: boolean + description: Indicates whether the query was processed successfully. + queryTime: + type: string + format: date-time + description: Time at which the query was made (Format:YYYY-MM-DD HH:mm:ss). + domainName: + type: string + description: Queried domain. + domainRegistered: + type: boolean + description: Indicates whether the domain is registered. + dnsTypes: + type: object + properties: + A: + type: number + AAAA: + type: number + MX: + type: number + NS: + type: number + SOA: + type: number + TXT: + type: number + SPF: + type: number + dnsRecords: + type: array + description: List of DNS records, each based on its type. + items: + oneOf: + - $ref: '#/components/schemas/DnsAorAAAARecord' + - $ref: '#/components/schemas/DnsCNAMERecord' + - $ref: '#/components/schemas/DnsMXRecord' + - $ref: '#/components/schemas/DnsNSRecord' + - $ref: '#/components/schemas/DnsSOARecord' + - $ref: '#/components/schemas/DnsTXTRecord' + DnsMXRecord: + type: object + required: + - name + - type + - dnsType + - ttl + - rawText + - rRsetType + - target + - priority + properties: + name: + type: string + description: Name of the queried domain + type: + type: integer + description: DNS type code (15 for MX) + dnsType: + type: string + enum: + - MX + description: DNS type as a string ("MX") + ttl: + type: integer + description: Time to live in seconds + rawText: + type: string + description: Raw (un-parsed) DNS record text + rRsetType: + type: integer + description: Indicates the resource record set type + target: + type: string + description: Targeted mail service provider + priority: + type: integer + description: Priority level associated with the mail server + title: MX Record + DnsNSRecord: + type: object + required: + - name + - type + - dnsType + - ttl + - rawText + - rRsetType + - singleName + properties: + name: + type: string + description: Name of the queried domain + type: + type: integer + description: DNS type code (2 for NS) + dnsType: + type: string + enum: + - NS + description: DNS type as a string ("NS") + ttl: + type: integer + description: Time to live in seconds + rawText: + type: string + description: Raw (un-parsed) DNS record text + rRsetType: + type: integer + description: Indicates the resource record set type + singleName: + type: string + description: Name server for that particular domain + title: NS Record + DnsReverseDnsResponse: + type: object + required: + - totalRecords + - totalPages + - currentPage + - reverseDnsRecords + properties: + totalRecords: + type: integer + totalPages: + type: integer + currentPage: + type: integer + reverseDnsRecords: + type: array + items: + type: object + required: + - queryTime + - domainName + - dnsTypes + - dnsRecords + properties: + queryTime: + type: string + format: date-time + domainName: + type: string + domainRegistered: + type: boolean + dnsTypes: + type: object + properties: + A: + type: number + AAAA: + type: number + CNAME: + type: number + MX: + type: number + NS: + type: number + SOA: + type: number + TXT: + type: number + SPF: + type: number + dnsRecords: + type: array + items: + oneOf: + - $ref: '#/components/schemas/DnsAorAAAARecord' + - $ref: '#/components/schemas/DnsCNAMERecord' + - $ref: '#/components/schemas/DnsMXRecord' + - $ref: '#/components/schemas/DnsNSRecord' + - $ref: '#/components/schemas/DnsSOARecord' + - $ref: '#/components/schemas/DnsTXTRecord' + DnsSOARecord: + type: object + required: + - name + - type + - dnsType + - ttl + - rawText + - rRsetType + - admin + - host + - expire + - minimum + - refresh + - retry + - serial + properties: + name: + type: string + description: Name of the queried domain + type: + type: integer + description: DNS type code (6 for SOA) + dnsType: + type: string + enum: + - SOA + description: DNS type as a string ("SOA") + ttl: + type: integer + description: Time to live in seconds + rawText: + type: string + description: Raw (un-parsed) DNS record text + rRsetType: + type: integer + description: Indicates the resource record set type + admin: + type: string + description: Administrative contact email for SOA records + host: + type: string + description: Primary name server for SOA records + expire: + type: string + description: Expiry time for SOA records + minimum: + type: integer + description: The minimum TTL for SOA records + refresh: + type: integer + description: Indicates the refresh interval for SOA records + retry: + type: integer + description: The retry interval for SOA records + serial: + type: integer + description: The serial number for SOA records + title: SOA Record + DnsTXTRecord: + type: object + required: + - name + - type + - dnsType + - ttl + - rawText + - rRsetType + - strings + properties: + name: + type: string + description: Name of the queried domain + type: + type: integer + description: DNS type code (16 for TXT, 99 for SPF) + dnsType: + type: string + enum: + - TXT + - SPF + description: DNS type as a string ("TXT" or "SPF") + ttl: + type: integer + description: Time to live in seconds + rawText: + type: string + description: Raw (un-parsed) DNS record text + rRsetType: + type: integer + description: Indicates the resource record set type + strings: + type: array + items: + type: string + description: List containing the verification strings + title: TXT / SPF Record + DomainBulkDomainSuggestionResponse: + title: Bulk Domain Suggestion Response + type: object + required: + - bulk_domain_availability_response + properties: + bulk_domain_availability_response: + type: array + description: List of domain availability objects. + items: + type: object + required: + - domain + - domainAvailability + - status + properties: + domain: + type: string + description: Name of the queried domain + domainAvailability: + type: boolean + description: True if available, false if not available + status: + type: boolean + description: Determines whether the request was successfully processed or not for that + specific entry. + DomainDomainAvailabilityResponse: + title: Domain Availability Response + type: object + required: + - domain + - domainAvailability + properties: + domain: + type: string + description: Name of the queried domain + domainAvailability: + type: boolean + description: True if available, false if not available + DomainDomainSuggestionResponse: + title: Domain Suggestion Response + type: object + required: + - domain_available_response + properties: + domain_available_response: + type: array + description: List of domain availability objects. + items: + type: object + required: + - domain + - domainAvailability + properties: + domain: + type: string + description: Name of the suggested domain + domainAvailability: + type: boolean + description: True if available, false if not available + DomainSubDomainResponse: + title: SubDomain Response + type: object + required: + - domain + - status + - query_time + - current_page + - total_pages + - total_records + - subdomains + properties: + domain: + type: string + description: The domain name for which subdomains are retrieved. + status: + type: boolean + description: Indicates whether the request was successfully processed or not. + query_time: + type: string + description: Timestamp showing when the API request was executed. + current_page: + type: integer + description: The current page number of the paginated response. + total_pages: + type: integer + description: Total number of pages available for the given query. Each page has 100 subdomain + entries. + total_records: + type: integer + description: Total number of subdomains found for the domain. + subdomains: + type: array + description: Returns an array of subdomain objects. Each object contains detailed information + about an individual subdomain. + items: + type: object + required: + - subdomain + - first_seen + - last_seen + properties: + subdomain: + type: string + description: The discovered subdomain associated with the given domain. + first_seen: + type: string + description: The date when the subdomain was first discovered. + last_seen: + type: string + description: The most recent date when the subdomain was observed. This field is only + returned if the subdomain has been re-detected after its initial discovery. + inactive_from: + type: string + description: The date from which the subdomain is considered inactive. This field appears + only if the subdomain is no longer active. + GeoDbAdmin_Level_Response: + type: object + properties: + admin_levels: + type: array + items: + type: string + required: + - admin_levels + GeoDbAdmin_Unit_Details_Response: + type: object + properties: + name: + type: string + admin_code: + type: string + admin_iso3166_2: + type: string + admin_level: + type: string + country_iso3166_2: + type: string + country_name: + type: string + required: + - name + - admin_code + - admin_iso3166_2 + - admin_level + - country_iso3166_2 + - country_name + GeoDbAdmin_Units_Response: + type: object + properties: + admin_units: + type: array + items: + type: object + properties: + name: + type: string + admin_code: + type: string + admin_level: + type: string + required: + - name + - admin_code + - admin_level + required: + - admin_units + GeoDbCities_Response: + type: object + properties: + cities: + type: array + items: + type: object + properties: + name: + type: string + latitude: + type: number + longitude: + type: number + admin_unit: + type: object + properties: + name: + type: string + admin_code: + type: string + admin_level: + type: string + required: + - name + - admin_code + - admin_level + iso_alpha_2: + type: string + required: + - name + - latitude + - longitude + - admin_unit + - iso_alpha_2 + required: + - cities + GeoDbCountries_Response: + type: object + properties: + countries: + type: array + items: + type: object + properties: + name: + type: string + iso_alpha_2: + type: string + iso_alpha_3: + type: string + iso_numeric: + type: integer + capital: + type: string + region: + type: string + subregion: + type: string + required: + - name + - iso_alpha_2 + - iso_alpha_3 + - iso_numeric + - capital + - region + - subregion + required: + - countries + GeoDbCountry_Details_Response: + type: object + properties: + name: + type: string + iso_alpha_2: + type: string + iso_alpha_3: + type: string + iso_numeric: + type: integer + phone_code: + type: integer + capital: + type: string + top_level_domain: + type: string + native_name: + type: string + region: + type: string + subregion: + type: string + nationality: + type: string + flag_emoji: + type: string + currency_code: + type: string + currency_name: + type: string + currency_symbol: + type: string + required: + - name + - iso_alpha_2 + - iso_alpha_3 + - iso_numeric + - phone_code + - capital + - top_level_domain + - native_name + - region + - subregion + - nationality + - flag_emoji + - currency_code + - currency_name + - currency_symbol + GeocodingForwardGeocoderResponse: + type: array + items: + type: object + required: + - lat + - lon + - country_code + - country + - full_address + - bounding_box + properties: + lat: + type: number + format: float + description: WGS84 latitude value for the location. + lon: + type: number + format: float + description: WGS84 longitude value for the location. + name: + type: string + description: Name for the primary place searched. + category: + type: string + description: High-level category of the place, e.g., amenity, place, natural, building, highway. + type: + type: string + description: Specific kind within the category, e.g., fast_food, city, park, residential, + house_number. + poi: + type: array + items: + type: object + properties: + name: + type: string + description: Name of the poi (point of interest) of the searched place. + category: + type: string + description: Category of the poi, e.g., amenity, place, natural, building, highway. + type: + type: string + description: Specific type of the category for the poi, e.g., fast_food, city, park, + residential, house_number. + description: Array describing the main POI and closely related elements at this location. + street: + type: string + description: Street or road name. + area: + type: string + description: Intra-city area below city level, e.g., suburb, borough, ward, district, tehsil, + neighbourhood. + postcode: + type: string + description: Postal code of the area. + city: + type: string + description: Settlement label appropriate to the country, e.g., city, town, municipality. + county: + type: string + description: Second-tier administrative area, e.g., county, district, prefecture. + state_code: + type: string + description: Subdivision code, typically ISO-3166-2 (e.g., US-TX, PK-PB). + state: + type: string + description: First-tier administrative area, e.g., state, region, province, division. + country_code: + type: string + description: Two-letter country code in upper case, ISO-3166-1 alpha-2. + country: + type: string + description: Country name of the searched place. + full_address: + type: string + description: Single-line, human-readable address of the location. + bounding_box: + type: array + items: + type: string + minItems: 4 + maxItems: 4 + description: Extent of the feature as [lat_min, lat_max, lon_min, lon_max] in WGS84 decimal + degrees. + GeocodingReverseGeocoderResponse: + type: object + required: + - lat + - lon + - country_code + - country + - full_address + - bounding_box + properties: + lat: + type: number + format: float + description: WGS84 latitude value for the location. + lon: + type: number + format: float + description: WGS84 longitude value for the location. + name: + type: string + description: Name for the primary place searched. + category: + type: string + description: High-level category of the place, e.g. amenity, place, natural, building, highway. + type: + type: string + description: Specific kind within the category, e.g. fast_food, city, park, residential, house_number. + poi: + type: array + description: Array describing the POI (point of interest) and closely related elements at this + location. + items: + type: object + properties: + name: + type: string + description: Name of the POI of the searched place. + category: + type: string + description: Category of the POI, e.g. amenity, place, natural, building, highway. + type: + type: string + description: Specific type of the category for the POI, e.g. fast_food, city, park, residential, + house_number. + street: + type: string + description: Street or road name. + area: + type: string + description: Intra-city area below city level, e.g. suburb, borough, quarter, ward, district, + sector, zone, tehsil, taluka, neighbourhood. + postcode: + type: string + description: Postal code of the area. + city: + type: string + description: Settlement label appropriate to the country, e.g. city, town, municipality. + county: + type: string + description: Second-tier administrative area, e.g. county, district, shire, prefecture. + state_code: + type: string + description: Subdivision code when available, typically ISO-3166-2 like US-TX or PK-PB. + state: + type: string + description: First-tier administrative area; varies by country, e.g. state, region, province, + division, autonomous community. + country_code: + type: string + description: Two-letter country code in upper case, ISO-3166-1 alpha-2. + country: + type: string + description: Country name of the searched place. + full_address: + type: string + description: Single-line, human-readable address of the location. + bounding_box: + type: array + items: + type: string + minItems: 4 + maxItems: 4 + description: Extent of the feature as `[lat_min, lat_max, lon_min, lon_max]` (south, north, + west, east) in WGS84 decimal degrees. + IpGeolocationBulkGeolocationResponse: + type: array + items: + $ref: '#/components/schemas/IpGeolocationGeolocationResponse' + example: + - ip: 8.8.8.8 + location: + continent_code: NA + continent_name: North America + country_code2: US + country_code3: USA + country_name: United States + country_name_official: United States of America + country_capital: Washington, D.C. + state_prov: California + state_code: US-CA + district: Santa Clara + city: Mountain View + locality: Mountain View + accuracy_radius: '39.202' + confidence: low + zipcode: 94043-1351 + latitude: '37.42240' + longitude: '-122.08421' + is_eu: false + country_flag: https://ipgeolocation.io/static/flags/us_64.png + geoname_id: '6301403' + country_emoji: 🇺🇸 + country_metadata: + calling_code: '+1' + tld: .us + languages: + - en-US + - es-US + - haw + - fr + network: + asn: + as_number: AS15169 + organization: Google LLC + country: US + asn_name: GOOGLE + type: BUSINESS + domain: google.com + date_allocated: '2000-03-30' + allocation_status: '' + num_of_ipv4_routes: '1064' + num_of_ipv6_routes: '155' + rir: ARIN + connection_type: '' + company: + name: Google LLC + type: Hosting + domain: google.com + currency: + code: USD + name: US Dollar + symbol: $ + - ip: 1.1.1.1 + location: + continent_code: OC + continent_name: Oceania + country_code2: AU + country_code3: AUS + country_name: Australia + country_name_official: Commonwealth of Australia + country_capital: Canberra + state_prov: Queensland + state_code: AU-QLD + district: Brisbane + city: South Brisbane + locality: South Brisbane + accuracy_radius: '12.582' + confidence: medium + zipcode: '4101' + latitude: '-27.47306' + longitude: '153.01421' + is_eu: false + country_flag: https://ipgeolocation.io/static/flags/au_64.png + geoname_id: '10113228' + country_emoji: 🇦🇺 + country_metadata: + calling_code: '+61' + tld: .au + languages: + - en-AU + network: + asn: + as_number: AS13335 + organization: Cloudflare, Inc. + country: US + asn_name: CLOUDFLARENET + type: BUSINESS + domain: cloudflare.com + date_allocated: '2010-07-14' + allocation_status: '' + num_of_ipv4_routes: '2472' + num_of_ipv6_routes: '3088' + rir: ARIN + connection_type: '' + company: + name: APNIC Research and Development + type: '' + domain: '' + currency: + code: AUD + name: Australian Dollar + symbol: A$ + - domain: dns.google.com + ip: 8.8.4.4 + location: + continent_code: NA + continent_name: North America + country_code2: US + country_code3: USA + country_name: United States + country_name_official: United States of America + country_capital: Washington, D.C. + state_prov: California + state_code: US-CA + district: Santa Clara + city: Mountain View + locality: Mountain View + accuracy_radius: '20.121' + confidence: low + zipcode: 94043-1351 + latitude: '37.42240' + longitude: '-122.08421' + is_eu: false + country_flag: https://ipgeolocation.io/static/flags/us_64.png + geoname_id: '6301403' + country_emoji: 🇺🇸 + country_metadata: + calling_code: '+1' + tld: .us + languages: + - en-US + - es-US + - haw + - fr + network: + asn: + as_number: AS15169 + organization: Google LLC + country: US + asn_name: GOOGLE + type: BUSINESS + domain: google.com + date_allocated: '2000-03-30' + allocation_status: '' + num_of_ipv4_routes: '1064' + num_of_ipv6_routes: '155' + rir: ARIN + connection_type: '' + company: + name: Google LLC + type: Hosting + domain: google.com + currency: + code: USD + name: US Dollar + symbol: $ + IpGeolocationBulkIPSecurityResponse: + type: array + items: + $ref: '#/components/schemas/IpGeolocationIPSecurityResponse' + example: + - ip: 8.8.8.8 + security: + threat_score: 5 + is_tor: false + is_proxy: false + proxy_provider_names: [] + proxy_confidence_score: 0 + proxy_last_seen: '' + is_residential_proxy: false + is_vpn: false + vpn_provider_names: [] + vpn_confidence_score: 0 + vpn_last_seen: '' + is_relay: false + relay_provider_name: '' + is_anonymous: false + is_known_attacker: false + is_bot: false + is_spam: false + is_cloud_provider: true + cloud_provider_name: Google LLC + - ip: 1.1.1.1 + security: + threat_score: 80 + is_tor: false + is_proxy: true + proxy_provider_names: + - Private Internet Access + proxy_confidence_score: 85 + proxy_last_seen: '2025-01-15' + is_residential_proxy: false + is_vpn: false + vpn_provider_names: [] + vpn_confidence_score: 0 + vpn_last_seen: '' + is_relay: false + relay_provider_name: '' + is_anonymous: true + is_known_attacker: true + is_bot: false + is_spam: false + is_cloud_provider: false + cloud_provider_name: '' + - ip: 45.33.32.156 + security: + threat_score: 5 + is_tor: false + is_proxy: false + proxy_provider_names: [] + proxy_confidence_score: 0 + proxy_last_seen: '' + is_residential_proxy: false + is_vpn: false + vpn_provider_names: [] + vpn_confidence_score: 0 + vpn_last_seen: '' + is_relay: false + relay_provider_name: '' + is_anonymous: false + is_known_attacker: false + is_bot: false + is_spam: false + is_cloud_provider: true + cloud_provider_name: Linode + IpGeolocationGeolocationResponse: + type: object + properties: + ip: + type: string + description: IP address that is used to lookup geolocation information. + domain: + type: string + description: Domain name that is used to lookup geolocation information. It is not returned + if an IP address is used to query IP Geolocation API. + hostname: + type: string + description: Hostname of the IP address used to query IP Geolocation API. + location: + type: object + description: The location information + properties: + continent_code: + type: string + description: 2-letter code of the continent. + continent_name: + type: string + description: Name of the continent. + country_code2: + type: string + description: Country code (ISO 3166-1 alpha-2) of the country. + country_code3: + type: string + description: Country code (ISO 3166-1 alpha-3) of the country. + country_name: + type: string + description: Name of the country. + country_name_official: + type: string + description: Official name (ISO 3166) of the country. + country_capital: + type: string + description: Name of the country’s capital. + state_prov: + type: string + description: Name of the state/province/region. + state_code: + type: string + description: Code of the state/province/region. + district: + type: string + description: Name of the district or county. + city: + type: string + description: Name of the city. + locality: + type: string + description: A more specific area in city or it can be same as city. + accuracy_radius: + type: string + description: Circular radius in Km, where the IP address location can be found. + dma_code: + type: string + description: Representing Designated Market Area (DMA) code specifically used in the United + States for media marketing. + nullable: true + zipcode: + type: string + description: ZIP/Postal code of the place. + latitude: + type: string + description: Latitude of the place. + longitude: + type: string + description: Longitude of the place. + is_eu: + type: boolean + description: Is the country belong to European Union? + country_flag: + type: string + format: uri + description: URL to get the country flag. + geoname_id: + type: string + description: Geoname ID of the place from geonames.org + country_emoji: + type: string + description: Emoji of the Country flag. + country_metadata: + type: object + description: The country metadata + properties: + calling_code: + type: string + description: Calling code/Dialing code of the country. + tld: + type: string + description: Top Level Domain Name (TLD) of the country, which is also called ccTLD. + languages: + type: array + items: + type: string + description: List of the languages’ codes, spoken in the country. + network: + type: object + description: The network information + properties: + asn: + type: object + properties: + as_number: + type: string + description: Autonomous system number of the autonomous system, to which IP address + belongs to. + organization: + type: string + description: Legal Full Name of AS organization holding the IP address. + country: + type: string + description: Name of the country, ASN is residing. + asn_name: + type: string + description: Name associated with the Autonomous System, usually representing organization. + type: + type: string + description: Type of the ASN, whether ISP, Business, etc. + domain: + type: string + description: Domain name associated with the ASN holding the IP address. + date_allocated: + type: string + description: Last date, when the IP address assigned to the ASN. e.g., in format 1st + June 2001 + allocation_status: + type: string + description: Whether the IP address is currently assigned to the ASN or not. + num_of_ipv4_routes: + type: string + description: Total number of IPv4 routes, held by the ASN. These Routes can be queried + from our ASN API. + num_of_ipv6_routes: + type: string + description: Total number of IPv6 routes, held by the ASN. These Routes can be queried + from our ASN API. + rir: + type: string + description: Name of the Regional Internet Registry (RIR) that allocated the AS number. + connection_type: + type: string + description: Type of the connection, consuming the IP address. + company: + type: object + properties: + name: + type: string + description: Name of the company/ISP holding the IP address. + type: + type: string + description: Type of the company whether it is an ISP, hosting provider or business, + etc. + domain: + type: string + description: Official domain name used by the company. + currency: + type: object + description: The currency information + properties: + code: + type: string + description: Currency code (ISO 4217). + example: PKR + name: + type: string + description: Currency name (ISO 4217). + example: Pakistan Rupee + symbol: + type: string + description: Currency symbol. + example: ₨ + security: + type: object + description: The security information + properties: + threat_score: + type: number + description: IP address’ threat score. It ranges from 0 to 100. 100 indicates highest threat + and vice versa for lower score. + is_tor: + type: boolean + description: Indicates if the IP address is being consumed on a Tor endpoint. + is_proxy: + type: boolean + description: Indicates whether the IP address is associated with any anonymization network + —VPN, PROXY, or RELAY. + proxy_type: + type: string + description: Specifies which of the three types (VPN, PROXY, or RELAY) applies when is_proxy + is true; otherwise remains empty. + nullable: true + proxy_provider: + type: string + description: Name of the proxy provider, if the IP address belongs to a proxy network. + nullable: true + is_anonymous: + type: boolean + description: Indicates if the IP address is being used anonymously. + is_known_attacker: + type: boolean + description: Indicates if the IP address is enlisted as an attacking IP address. + is_spam: + type: boolean + description: Indicates if the IP address is enlisted as a spam IP address. + is_bot: + type: boolean + description: Indicates if the IP address is enlisted as a bot IP address. + is_cloud_provider: + type: boolean + description: Indicates if the IP address belongs to a cloud provider (computing infrastructure + providers). + cloud_provider: + type: string + description: Name of the Cloud Provider, if the IP address belongs to a cloud provider. + nullable: true + abuse: + type: object + description: The abuse information + properties: + route: + type: string + description: Network route associated with the IP address. + country: + type: string + description: Country where the responsible entity is located. + handle: + type: string + description: Abuse handle or ID found in WHOIS or RDAP records. + name: + type: string + description: Name of the abuse contact person or entity. + organization: + type: string + description: Organization responsible for the IP address. + role: + type: string + description: Role of the contact (e.g., abuse, administrative, registrant, etc.). + kind: + type: string + description: 'Type of contact: individual, team, or organization.' + address: + type: string + description: Physical mailing address of the responsible entity. + emails: + type: array + items: + type: string + description: Email address(es) of the abuse contact. + phone_numbers: + type: array + items: + type: string + description: Phone number(s) in international format for the abuse contact. + time_zone: + type: object + description: The time zone information + properties: + name: + type: string + description: Name (ISO 8601) of the time zone. + offset: + type: number + description: Time zone offset from UTC. + offset_with_dst: + type: number + description: Time zone with DST offset from UTC. + current_time: + type: string + description: Current time in yyyy-MM-dd HH:mm:ss.SSS±ZZZ format. + current_time_unix: + type: number + description: Current time in seconds since 1970. + is_dst: + type: boolean + description: Is the time zone in daylight savings? + dst_savings: + type: number + description: Total daylight savings. + dst_exists: + type: boolean + description: Indicates whether Daylight Saving Time (DST) is observed in the region. If + true, the dst_start and dst_end objects will include detailed DST transition information. + dst_start: + type: object + properties: + utc_time: + type: string + description: The date and time in UTC when DST begins. + duration: + type: string + description: The time change that occurs when DST starts. + gap: + type: boolean + description: Is there a gap when the clocks jump forward or not. + date_time_after: + type: string + description: The local date and time that immediately follows the start of DST. + date_time_before: + type: string + description: The local date and time immediately before DST begins. + overlap: + type: boolean + description: Whether there is an overlap of time due to clocks being set back when DST + starts. + dst_end: + type: object + properties: + utc_time: + type: string + description: The date and time in UTC when DST ends. + duration: + type: string + description: The time change that occurs when DST ends. + gap: + type: boolean + description: Is there a gap when the clocks jump backward or not. + date_time_after: + type: string + description: The local date and time that immediately follows the ends of DST. + date_time_before: + type: string + description: The local date and time immediately before DST ends. + overlap: + type: boolean + description: Whether there is an overlap of time due to clocks being set back when DST + ends. + user_agent: + type: object + description: The user agent information + properties: + user_agent_string: + type: string + description: User-Agent string passed along with the query in the User-Agent header. + example: Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:142.0) Gecko/20100101 Firefox/142.0 + name: + type: string + description: User-Agent Name. + example: Firefox + type: + type: string + description: User-Agent Class. + example: Browser + version: + type: string + description: User-Agent Version. + example: '142.0' + version_major: + type: string + description: User-Agent Version Major. + example: '142' + device: + type: object + properties: + name: + type: string + description: Device Name. + example: Linux Desktop + type: + type: string + description: Device Type. + example: Desktop + brand: + type: string + description: Device Brand. + example: Unknown + cpu: + type: string + description: Device CPU Model. + example: Intel x86_64 + engine: + type: object + properties: + name: + type: string + description: Layout Engine Name. + example: Gecko + type: + type: string + description: Layout Engine Class. + example: Browser + version: + type: string + description: Layout Engine Version. + example: '142.0' + version_major: + type: string + description: Layout Engine Version Major. + example: '142' + operating_system: + type: object + properties: + name: + type: string + description: Operating System Name. + example: Ubuntu + type: + type: string + description: Operating System Class. + example: Desktop + version: + type: string + description: Operating System Version. + example: ?? + version_major: + type: string + description: Operating System Version Major. + example: ?? + build: + type: string + description: Operating System Build. + example: ?? + example: + ip: 8.8.8.8 + location: + continent_code: NA + continent_name: North America + country_code2: US + country_code3: USA + country_name: United States + country_name_official: United States of America + country_capital: Washington, D.C. + state_prov: California + state_code: US-CA + district: Santa Clara + city: Mountain View + locality: Mountain View + accuracy_radius: '23.387' + confidence: low + zipcode: 94043-1351 + latitude: '37.42240' + longitude: '-122.08421' + is_eu: false + country_flag: https://ipgeolocation.io/static/flags/us_64.png + geoname_id: '6301403' + country_emoji: 🇺🇸 + country_metadata: + calling_code: '+1' + tld: .us + languages: + - en-US + - es-US + - haw + - fr + network: + asn: + as_number: AS15169 + organization: Google LLC + country: US + asn_name: GOOGLE + type: BUSINESS + domain: about.google + date_allocated: '' + allocation_status: assigned + num_of_ipv4_routes: '996' + num_of_ipv6_routes: '104' + rir: ARIN + connection_type: '' + company: + name: Google LLC + type: '' + domain: '' + currency: + code: USD + name: US Dollar + symbol: $ + IpGeolocationIPSecurityResponse: + type: object + properties: + ip: + type: string + description: IP address that is used to lookup security information. + security: + type: object + description: The security information + properties: + threat_score: + type: number + description: Overall threat score for the IP address. Ranges from 0 to 100. 100 indicates + the highest risk. + is_tor: + type: boolean + description: Indicates whether the IP is a Tor exit node. + is_proxy: + type: boolean + description: Indicates whether the IP is associated with a proxy network. + proxy_provider_names: + type: array + items: + type: string + description: List of detected proxy provider names, when available. + nullable: true + proxy_confidence_score: + type: number + description: Confidence score (0–100) for proxy detection, when flag is true. Defaults to + 0. + proxy_last_seen: + type: string + description: Last seen date (YYYY-MM-DD) for proxy activity, when available. + nullable: true + is_residential_proxy: + type: boolean + description: Indicates whether the IP is associated with a residential proxy network. + is_vpn: + type: boolean + description: Indicates whether the IP is associated with a VPN network. + vpn_provider_names: + type: array + items: + type: string + description: List of detected VPN provider names, when available. + nullable: true + vpn_confidence_score: + type: number + description: Confidence score (0–100) for VPN detection, when flag is true. Defaults to + 0. + vpn_last_seen: + type: string + description: Last seen date (YYYY-MM-DD) for VPN activity, when available. + nullable: true + is_relay: + type: boolean + description: Indicates whether the IP is associated with a relay network. + relay_provider_name: + type: string + description: Relay provider name, when available. + nullable: true + is_anonymous: + type: boolean + description: Indicates whether the IP is anonymous. True if VPN, proxy, Tor, or relay is + detected. + is_known_attacker: + type: boolean + description: Indicates whether the IP is flagged for known attacker behavior. + is_bot: + type: boolean + description: Indicates whether the IP is associated with bot activity. + is_spam: + type: boolean + description: Indicates whether the IP is associated with spam activity. + is_cloud_provider: + type: boolean + description: Indicates whether the IP belongs to a cloud provider. + cloud_provider_name: + type: string + description: Name of the Cloud Provider, if the IP address belongs to a cloud provider. + nullable: true + example: + ip: 8.8.8.8 + security: + threat_score: 5 + is_tor: false + is_proxy: false + proxy_provider_names: [] + proxy_confidence_score: 0 + proxy_last_seen: '' + is_residential_proxy: false + is_vpn: false + vpn_provider_names: [] + vpn_confidence_score: 0 + vpn_last_seen: '' + is_relay: false + relay_provider_name: '' + is_anonymous: false + is_known_attacker: false + is_bot: false + is_spam: false + is_cloud_provider: true + cloud_provider_name: Google LLC + OtherAstronomyResponse: + type: object + required: + - astronomy + properties: + ip: + type: string + description: IPv4 or IPv6 address used for the lookup. Returned only when queried using the + ip= parameter. + location: + type: object + description: The location information + properties: + location_string: + type: string + description: The provided location parameter as location. + continent_code: + type: string + description: The two-letter code of the continent (e.g., "NA"). + continent_name: + type: string + description: The full name of the continent (e.g., "North America"). + country_code2: + type: string + description: The ISO 3166-1 alpha-2 two-letter country code (e.g., "US"). + country_code3: + type: string + description: The ISO 3166-1 alpha-3 three-letter country code (e.g., "USA"). + country_name: + type: string + description: The common name of the country (e.g., "United States"). + country_name_official: + type: string + description: The official full name of the country (e.g., "United States of America"). + is_eu: + type: boolean + description: Is the country belong to European Union? + state_prov: + type: string + description: Name of the state/province/region. + state_code: + type: string + description: Code of the state/province/region. + district: + type: string + description: Name of the district or county. + city: + type: string + description: Name of the city. + zipcode: + type: string + description: ZIP/Postal code of the place. + latitude: + type: string + description: The geographic latitude of the location. + longitude: + type: string + description: The geographic longitude of the location. + locality: + type: string + description: Smaller area, part or region of a city. + elevation: + type: string + description: The elevation of the geographical location. + astronomy: + type: object + required: + - time_zone + - date + - current_time + - mid_night + - night_end + - morning + - sunrise + - sunset + - evening + - night_begin + - sun_status + - solar_noon + - day_length + - sun_altitude + - sun_distance + - sun_azimuth + - moon_phase + - moonrise + - moonset + - moon_status + - moon_altitude + - moon_distance + - moon_azimuth + - moon_parallactic_angle + - moon_illumination_percentage + - moon_angle + properties: + time_zone: + type: string + description: Appears (with the provided value) only when the user includes a time_zone in + the query to specify which time to observe. + date: + type: string + description: The current date + current_time: + type: string + description: The current time + mid_night: + type: string + description: The time of midnight (solar-based) + night_end: + type: string + description: The time when night ends (start of astronomical twilight) + morning: + type: object + required: + - astronomical_twilight_begin + - astronomical_twilight_end + - nautical_twilight_begin + - nautical_twilight_end + - civil_twilight_begin + - civil_twilight_end + - blue_hour_begin + - blue_hour_end + - golden_hour_begin + - golden_hour_end + properties: + astronomical_twilight_begin: + type: string + description: The start time of astronomical twilight in the morning + astronomical_twilight_end: + type: string + description: The end time of astronomical twilight in the morning + nautical_twilight_begin: + type: string + description: The start time of nautical twilight in the morning + nautical_twilight_end: + type: string + description: The end time of nautical twilight in the morning + civil_twilight_begin: + type: string + description: The start time of civil twilight in the morning + civil_twilight_end: + type: string + description: The end time of civil twilight in the morning + blue_hour_begin: + type: string + description: The beginning of the blue hour in the morning + blue_hour_end: + type: string + description: The end of the blue hour in the morning + golden_hour_begin: + type: string + description: The beginning of the golden hour in the morning + golden_hour_end: + type: string + description: The end of the golden hour in the morning + sunrise: + type: string + description: The time of sunrise + sunset: + type: string + description: The time of sunset + evening: + type: object + required: + - golden_hour_begin + - golden_hour_end + - blue_hour_begin + - blue_hour_end + - civil_twilight_begin + - civil_twilight_end + - nautical_twilight_begin + - nautical_twilight_end + - astronomical_twilight_begin + - astronomical_twilight_end + properties: + golden_hour_begin: + type: string + description: The beginning of the golden hour in the evening + golden_hour_end: + type: string + description: The end of the golden hour in the evening + blue_hour_begin: + type: string + description: The beginning of the blue hour in the evening + blue_hour_end: + type: string + description: The end of the blue hour in the evening + civil_twilight_begin: + type: string + description: The start of civil twilight in the evening + civil_twilight_end: + type: string + description: The end of civil twilight in the evening + nautical_twilight_begin: + type: string + description: The start of nautical twilight in the evening + nautical_twilight_end: + type: string + description: The end of nautical twilight in the evening + astronomical_twilight_begin: + type: string + description: The start of astronomical twilight in the evening + astronomical_twilight_end: + type: string + description: The end of astronomical twilight in the evening + night_begin: + type: string + description: The time when night begins (end of astronomical twilight) + sun_status: + type: string + description: The current status of the sun (e.g., "rising", "setting", "-") + solar_noon: + type: string + description: The time when the sun reaches its highest point in the sky + day_length: + type: string + description: The total duration of daylight + sun_altitude: + type: number + format: float + description: The altitude angle of the sun above the horizon in degrees + sun_distance: + type: number + format: float + description: The distance from the Earth to the sun in kilometers + sun_azimuth: + type: number + format: float + description: The azimuth angle of the sun in degrees from true north + moon_phase: + type: string + description: The current phase of the moon (e.g., "WAXING_GIBBOUS") + moonrise: + type: string + description: The time of moonrise + moonset: + type: string + description: The time of moonset + moon_status: + type: string + description: The current status of the moon (e.g., "rising", "setting", "-") + moon_altitude: + type: number + format: float + description: The altitude angle of the moon above the horizon in degrees + moon_distance: + type: number + format: float + description: The distance from the Earth to the moon in kilometers + moon_azimuth: + type: number + format: float + description: The azimuth angle of the moon in degrees from true north + moon_parallactic_angle: + type: number + format: float + description: The parallactic angle of the moon in degrees + moon_illumination_percentage: + type: string + description: The percentage of the moon illuminated by sunlight + moon_angle: + type: number + format: float + description: The geometric angle of the moon relative to the observer + example: + location: + location_string: New York, US + country_name: United States + state_prov: New York + city: New York + locality: Clinton + latitude: '40.76473' + longitude: '-74.00084' + elevation: '9' + astronomy: + date: '2026-06-04' + current_time: '06:02:14.117' + mid_night: 00:54 + night_end: 03:23 + morning: + astronomical_twilight_begin: 03:23 + astronomical_twilight_end: 04:11 + nautical_twilight_begin: 04:11 + nautical_twilight_end: 04:53 + civil_twilight_begin: 04:53 + civil_twilight_end: 05:25 + sunrise: 05:25 + sun_transit: '12:53' + sunset: '20:21' + evening: + civil_twilight_begin: '20:21' + civil_twilight_end: '20:53' + nautical_twilight_begin: '20:53' + nautical_twilight_end: '21:35' + astronomical_twilight_begin: '21:35' + astronomical_twilight_end: '22:23' + golden_hour: + golden_hour_begin: 05:25 + golden_hour_end: 06:24 + golden_hour_evening_begin: '19:23' + golden_hour_evening_end: '20:21' + blue_hour: + blue_hour_morning_begin: 04:53 + blue_hour_morning_end: 05:25 + blue_hour_evening_begin: '20:21' + blue_hour_evening_end: '20:53' + day_length: '14:55:36' + day_length_seconds: 53736 + sun_distance: '151854887.930' + sun_distance_km: '151854887.930' + sun_azimuth: '73.73' + sun_altitude: '3.24' + sun_parallactic_angle: '41.05' + moon: + moon_phase: Waning Crescent + moon_phase_fraction: '0.04' + moon_illumination_percentage: '4' + moonrise: 04:15 + moonset: '19:17' + moon_transit: '11:43' + moon_distance: '369278.723' + moon_distance_km: '369278.723' + moon_azimuth: '62.36' + moon_altitude: '0.61' + moon_parallactic_angle: '44.36' + next_full_moon: '2026-06-29' + next_full_moon_utc: '2026-06-29T04:57:00' + next_new_moon: '2026-07-13' + next_new_moon_utc: '2026-07-13T10:44:00' + moon_days: '27.78' + SslSSLLookupResponse: + type: object + required: + - domainName + - queryTime + - sslCertificates + properties: + domainName: + type: string + queryTime: + type: string + format: date-time + sslCertificates: + type: array + items: + type: object + required: + - chainOrder + - authenticationType + - validityStartDate + - validityEndDate + - serialNumber + - signatureAlgorithm + - pemRaw + - subject + - issuer + - publicKey + - extensions + properties: + chainOrder: + type: string + authenticationType: + type: string + validityStartDate: + type: string + validityEndDate: + type: string + serialNumber: + type: string + signatureAlgorithm: + type: string + pemRaw: + type: string + subject: + type: object + required: + - commonName + properties: + commonName: + type: string + organization: + type: string + organizationalUnit: + type: string + locality: + type: string + state: + type: string + country: + type: string + incCountry: + type: string + incState: + type: string + businessCategory: + type: string + street: + type: string + postalCode: + type: string + serialNumber: + type: string + issuer: + type: object + required: + - commonName + - organization + - country + properties: + commonName: + type: string + organization: + type: string + organizationalUnit: + type: string + locality: + type: string + state: + type: string + country: + type: string + incCountry: + type: string + incState: + type: string + businessCategory: + type: string + street: + type: string + postalCode: + type: string + serialNumber: + type: string + publicKey: + type: object + required: + - keySize + - keyAlgorithm + - pemRaw + properties: + keySize: + type: string + keyAlgorithm: + type: string + pemRaw: + type: string + extensions: + type: object + required: + - keyUsages + properties: + authorityKeyIdentifier: + type: string + subjectKeyIdentifier: + type: string + keyUsages: + type: array + items: + type: string + extendedKeyUsages: + type: array + items: + type: string + crlDistributionPoints: + type: array + items: + type: string + authorityInfoAccess: + type: object + properties: + issuers: + type: array + items: + type: string + ocsp: + type: array + items: + type: string + subjectAlternativeNames: + type: object + properties: + dnsNames: + type: array + items: + type: string + emailAddresses: + type: array + items: + type: string + ipAddresses: + type: array + items: + type: string + uris: + type: array + items: + type: string + certificatePolicies: + type: array + items: + type: object + properties: + policyId: + type: string + policyQualifier: + type: object + properties: + oid: + type: string + cpsUri: + type: string + userNotice: + type: object + properties: + explicitText: + type: string + noticeRef: + type: object + properties: + organization: + type: string + noticeNumbers: + type: string + sslRaw: + type: string + TimezoneTimezoneConversionResponse: + type: object + required: + - original_time + - converted_time + - diff_hour + - diff_min + properties: + original_time: + type: string + format: date-time + description: Original time before conversion + example: '2024-09-01 00:00:00' + converted_time: + type: string + format: date-time + description: Time after conversion + example: '2024-09-01 09:00:00' + diff_hour: + type: number + format: float + description: Difference in hours + example: 9 + diff_min: + type: number + format: float + description: Difference in minutes + example: 540 + TimezoneTimezoneResponse: + type: object + properties: + ip: + type: string + format: ipv4 + time_zone: + type: object + required: + - name + - offset + - offset_with_dst + - date + - date_time + - date_time_txt + - date_time_wti + - date_time_ymd + - date_time_unix + - time_24 + - time_12 + - week + - month + - year + - year_abbr + - is_dst + - dst_savings + - dst_exists + - dst_start + - dst_end + properties: + name: + type: string + offset: + type: number + offset_with_dst: + type: number + date: + type: string + format: date + date_time: + type: string + format: date-time + date_time_txt: + type: string + date_time_wti: + type: string + date_time_ymd: + type: string + date_time_unix: + type: number + time_24: + type: string + time_12: + type: string + week: + type: integer + month: + type: integer + year: + type: integer + year_abbr: + type: string + is_dst: + type: boolean + dst_savings: + type: number + dst_exists: + type: boolean + dst_start.utc_time: + type: string + description: The date and time in UTC when DST begins. + dst_start.duration: + type: string + description: The time change that occurs when DST starts. + dst_start.gap: + type: boolean + description: Is there a gap when the clocks jump forward or not. + dst_start.date_time_after: + type: string + description: The local date and time that immediately follows the start of DST. + dst_start.date_time_before: + type: string + description: The local date and time immediately before DST begins. + dst_start.overlap: + type: boolean + description: Whether there is an overlap of time due to clocks being set back when DST starts. + dst_end.utc_time: + type: string + description: The date and time in UTC when DST ends. + dst_end.duration: + type: string + description: The time change that occurs when DST ends. + dst_end.gap: + type: boolean + description: Is there a gap when the clocks jump backward or not. + dst_end.date_time_after: + type: string + description: The local date and time that immediately follows the ends of DST. + dst_end.date_time_before: + type: string + description: The local date and time immediately before DST ends. + dst_end.overlap: + type: boolean + description: Whether there is an overlap of time due to clocks being set back when DST ends. + location: + type: object + properties: + location_string: + type: string + example: Lahore + continent_code: + type: string + example: AS + continent_name: + type: string + example: Asia + country_code2: + type: string + example: PK + country_code3: + type: string + example: PAK + country_name: + type: string + example: Pakistan + country_name_official: + type: string + example: Islamic Republic of Pakistan + is_eu: + type: boolean + example: false + state_prov: + type: string + example: Punjab + state_code: + type: string + example: PK-PB + district: + type: string + example: Lahore + city: + type: string + example: Lahore + locality: + type: string + example: '' + zipcode: + type: string + example: '54000' + latitude: + type: string + example: '31.56568' + longitude: + type: string + example: '74.31418' + airport_detail: + type: object + properties: + type: + type: string + example: large_airport + name: + type: string + example: London Heathrow Airport + latitude: + type: number + example: 51.4706 + longitude: + type: number + example: -0.46194 + elevation_ft: + type: number + example: 83 + continent_code: + type: string + example: EU + country_code: + type: string + example: GB + state_code: + type: string + example: GB-ENG + city: + type: string + example: London + iata_code: + type: string + example: LHR + icao_code: + type: string + example: EGLL + faa_code: + type: string + example: '' + lo_code_details: + type: object + properties: + lo_code: + type: string + example: NLRTM + city: + type: string + example: Rotterdam + state_code: + type: string + example: ZH + country_code: + type: string + example: NL + country_name: + type: string + example: '' + location_type: + type: string + example: Port, Rail Terminal, Road Terminal, Airport, Postal Exchange + latitude: + type: number + example: 51.91667 + longitude: + type: number + example: 4.5 + UserAgentBulkUserAgentParserResponse: + type: array + items: + $ref: '#/components/schemas/UserAgentUserAgentParserResponse' + UserAgentUserAgentParserResponse: + type: object + required: + - userAgentString + - name + - type + - version + - versionMajor + - device + - engine + - operatingSystem + properties: + user_agent_string: + type: string + description: User-agent string that is parsed for browser, device and operating system details. + example: Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:142.0) Gecko/20100101 Firefox/142.0 + name: + type: string + description: Agent name or the actual browser name that was used. + example: Firefox + type: + type: string + description: 'Agent type or the browser type that was used. Possible values: + + 1. Browser + + 2. Browser Webview + + 3. Mobile App + + 4. Robot Mobile + + 5. Cloud Application + + 6. Email Client + + 7. Voice + + 8. Special + + 9. Testclient + + 10. Hacker + + 11. Unknown + + ' + example: Browser + version: + type: string + description: Agent version or the browser version + example: '142.0' + versionMajor: + type: string + description: Agent version major or the browser version major + example: '142' + device: + type: object + required: + - name + - type + - brand + - CPU + properties: + name: + type: string + description: Device name or the hardware that was used + example: Linux Desktop + type: + type: string + description: 'Device type or the hardware type. Possible values: + + 1. Desktop + + 2. Mobile + + 3. Tablet + + 4. Phone + + 5. Watch + + 6. Virtual Reality + + 7. eReader + + 8. Set-top box + + 9. TV + + 10. Game Console + + 11. Handheld Game Console + + 12. Voice + + 13. Robot + + 14. Robot Mobile + + 15. Robot Imitator + + 16. Hacker + + 17. Anonymized + + 18. Unknown + + ' + example: Desktop + brand: + type: string + description: Device brand or the hardware brand name + example: Unknown + CPU: + type: string + description: Device's CPU model or machine CPU + example: Intel x86_64 + engine: + type: object + required: + - name + - type + - version + - versionMajor + - build + properties: + name: + type: string + description: Layout engine name or the underlying core that converts the HTML into visual + example: Gecko + type: + type: string + description: 'Layout engine type. Possible values: + + 1. Browser + + 2. Mobile App + + 3. Hacker + + 4. Robot + + 5. Unknown + + ' + example: Browser + version: + type: string + description: Layout engine version + example: '142.0' + versionMajor: + type: string + description: Layout engine version major + example: '142' + build: + type: string + description: Layout engine build + example: '' + operatingSystem: + type: object + required: + - name + - type + - version + - versionMajor + properties: + name: + type: string + description: Operating system name or the base software name that runs on the hardware. + example: Ubuntu + type: + type: string + description: 'Operating system type. Possible values: + + 1. Desktop + + 2. Mobile + + 3. Game Console + + 4. Embedded + + 5. Cloud + + 6. Hacker + + 7. Anonymized + + 8. Unknown + + ' + example: Desktop + version: + type: string + description: Operating system version + example: ?? + versionMajor: + type: string + description: Operating system version major + example: ?? + build: + type: string + description: Operating system build + example: ?? + WhoisASNLookupResponse: + type: object + required: + - asNumber + - asName + - orgName + - orgHandle + - country + - allocationStatus + - numOfIPv4Routes + - numOfIPv6Routes + - whoisHost + - type + - routeObjects + - whoisResponse + - downstreams + - parsedWhoisResponse + - upstreams + - peers + - contacts + - legacyRoutes + properties: + asNumber: + type: string + asName: + type: string + orgName: + type: string + description: + type: string + orgHandle: + type: string + country: + type: string + domain: + type: string + website: + type: string + allocationStatus: + type: string + numOfIPv4Routes: + type: string + numOfIPv6Routes: + type: string + whoisHost: + type: string + dateAllocated: + type: string + format: date + type: + type: string + routeObjects: + type: array + items: + type: object + required: + - route + - origin + - originName + - isp + - numberOfIps + properties: + route: + type: string + origin: + type: string + originName: + type: string + isp: + type: string + numberOfIps: + type: integer + whoisResponse: + type: string + downstreams: + type: array + items: + type: object + properties: + asNumber: + type: string + description: + type: string + country: + type: string + parsedWhoisResponse: + type: object + required: + - status + - whois_server + - aut_nums + - organization + - technical_contacts + - abuse_contacts + properties: + status: + type: boolean + whois_server: + type: string + aut_nums: + type: array + items: + type: object + required: + - aut_num + - as_handle + - as_name + - tech_contacts + - abuse_contacts + - date_created + - date_updated + - source + properties: + aut_num: + type: string + as_handle: + type: string + as_name: + type: string + description: + type: array + items: + type: string + country: + type: string + status: + type: string + member_of: + type: array + items: + type: string + import_via: + type: array + items: + type: string + import: + type: array + items: + type: string + mp_import: + type: array + items: + type: string + export_via: + type: array + items: + type: string + export: + type: array + items: + type: string + mp_export: + type: array + items: + type: string + default: + type: array + items: + type: string + mp_default: + type: array + items: + type: string + organization: + type: string + sponsoring_organization: + type: string + admin_contacts: + type: array + items: + type: string + tech_contacts: + type: array + items: + type: string + abuse_contacts: + type: array + items: + type: string + date_created: + type: string + format: date + date_updated: + type: string + format: date + source: + type: string + organization: + type: object + properties: + handle: + type: string + name: + type: string + address: + type: array + items: + type: string + street: + type: string + city: + type: string + state: + type: string + zip_code: + type: string + country: + type: array + items: + type: string + addressCountry: + type: string + date_created: + type: string + format: date + date_updated: + type: string + format: date + source: + type: string + technical_contacts: + type: array + items: + type: object + required: + - handle + - name + - email + properties: + handle: + type: string + name: + type: string + email: + type: array + items: + type: string + phone: + type: array + items: + type: string + source: + type: string + abuse_contacts: + type: array + items: + type: object + required: + - handle + - name + - email + properties: + handle: + type: string + name: + type: string + email: + type: array + items: + type: string + phone: + type: array + items: + type: string + source: + type: string + whois_raw_response: + type: string + r_whois_raw_response: + type: string + query_time: + type: string + format: date-time + upstreams: + type: array + items: + type: object + required: + - asNumber + - description + - country + properties: + asNumber: + type: string + description: + type: string + country: + type: string + peers: + type: array + items: + type: object + required: + - asNumber + - description + - country + properties: + asNumber: + type: string + description: + type: string + country: + type: string + contacts: + type: object + required: + - emailContacts + - abuseContacts + properties: + emailContacts: + type: array + items: + type: string + abuseContacts: + type: array + items: + type: string + legacyRoutes: + type: array + items: + type: string + WhoisBulkWhoisLookupResponse: + type: object + properties: + bulk_whois_response: + type: array + items: + $ref: '#/components/schemas/WhoisDomainWhoisLookupResponse' + WhoisDomainWHOISHistoricalLookupResponse: + type: object + required: + - status + - whois + - total_records + - whois_domains_historical + properties: + status: + type: boolean + description: Determines whether the request was successfully processed or not. + whois: + type: string + enum: + - historical + description: Indicates that this response contains historical data. + total_records: + type: string + description: Shows the total number of records found for the queried domain. + whois_domains_historical: + type: array + items: + type: object + required: + - num + - status + - domain_name + - query_time + - whois_server + - domain_registered + properties: + num: + type: integer + description: Shows the number of the record in the array. + status: + type: boolean + enum: + - true + description: Always true. + domain_name: + type: string + description: Domain name which was queried. + query_time: + type: string + format: date-time + description: The timestamp when the query was made. + whois_server: + type: string + description: The WHOIS server that provided the domain information. + domain_registered: + type: string + enum: + - 'yes' + - 'no' + - restricted + description: Domain registration status. + create_date: + type: string + format: date + description: Date when the domain was initially registered. + update_date: + type: string + format: date + description: The date of the most recent update to the domain registration. + expiry_date: + type: string + format: date + description: The date when the domain registration will expire if not renewed. + domain_registrar: + type: object + properties: + iana_id: + type: string + registrar_name: + type: string + whois_server: + type: string + website_url: + type: string + email_address: + type: string + phone_number: + type: string + reseller_contact: + type: object + properties: + name: + type: string + email_address: + type: string + phone: + type: string + registrant_contact: + type: object + properties: + name: + type: string + company: + type: string + street: + type: string + city: + type: string + state: + type: string + zip_code: + type: string + country_name: + type: string + country_code: + type: string + email_address: + type: string + phone: + type: string + fax: + type: string + mailing_address: + type: string + administrative_contact: + type: object + properties: + name: + type: string + company: + type: string + street: + type: string + city: + type: string + state: + type: string + zip_code: + type: string + country_name: + type: string + country_code: + type: string + email_address: + type: string + phone: + type: string + fax: + type: string + mailing_address: + type: string + technical_contact: + type: object + properties: + name: + type: string + company: + type: string + street: + type: string + city: + type: string + state: + type: string + zip_code: + type: string + country_name: + type: string + country_code: + type: string + email_address: + type: string + phone: + type: string + fax: + type: string + mailing_address: + type: string + billing_contact: + type: object + properties: + name: + type: string + company: + type: string + street: + type: string + city: + type: string + state: + type: string + zip_code: + type: string + country_name: + type: string + country_code: + type: string + email_address: + type: string + phone: + type: string + fax: + type: string + mailing_address: + type: string + name_servers: + type: array + items: + type: string + domain_status: + type: array + items: + type: string + whois_raw_domain: + type: string + registry_data: + type: object + properties: + domain_name: + type: string + query_time: + type: string + format: date-time + whois_server: + type: string + domain_registered: + type: string + enum: + - 'yes' + - 'no' + - restricted + create_date: + type: string + format: date + update_date: + type: string + format: date + expiry_date: + type: string + format: date + name_servers: + type: array + items: + type: string + domain_status: + type: array + items: + type: string + whois_raw_registry: + type: string + domain_registrar: + type: object + properties: + iana_id: + type: string + registrar_name: + type: string + whois_server: + type: string + website_url: + type: string + email_address: + type: string + phone_number: + type: string + WhoisDomainWhoisLookupResponse: + type: object + properties: + status: + type: boolean + domain_name: + type: string + query_time: + type: string + format: date-time + whois_server: + type: string + domain_registered: + type: string + enum: + - 'yes' + - 'no' + - restricted + create_date: + type: string + format: date + nullable: true + update_date: + type: string + format: date + nullable: true + expiry_date: + type: string + format: date + nullable: true + domain_registrar: + type: object + properties: + iana_id: + type: string + nullable: true + registrar_name: + type: string + nullable: true + whois_server: + type: string + nullable: true + website_url: + type: string + format: uri + nullable: true + email_address: + type: string + format: email + nullable: true + phone_number: + type: string + nullable: true + reseller_contact: + type: object + properties: + name: + type: string + nullable: true + company: + type: string + nullable: true + street: + type: string + nullable: true + city: + type: string + nullable: true + state: + type: string + nullable: true + zip_code: + type: string + nullable: true + country_name: + type: string + nullable: true + country_code: + type: string + nullable: true + email_address: + type: string + format: email + nullable: true + phone: + type: string + nullable: true + fax: + type: string + nullable: true + mailing_address: + type: string + nullable: true + registrant_contact: + type: object + properties: + name: + type: string + nullable: true + company: + type: string + nullable: true + street: + type: string + nullable: true + city: + type: string + nullable: true + state: + type: string + nullable: true + zip_code: + type: string + nullable: true + country_name: + type: string + nullable: true + country_code: + type: string + nullable: true + email_address: + type: string + format: email + nullable: true + phone: + type: string + nullable: true + fax: + type: string + nullable: true + mailing_address: + type: string + nullable: true + administrative_contact: + type: object + properties: + name: + type: string + nullable: true + company: + type: string + nullable: true + street: + type: string + nullable: true + city: + type: string + nullable: true + state: + type: string + nullable: true + zip_code: + type: string + nullable: true + country_name: + type: string + nullable: true + country_code: + type: string + nullable: true + email_address: + type: string + format: email + nullable: true + phone: + type: string + nullable: true + fax: + type: string + nullable: true + mailing_address: + type: string + nullable: true + technical_contact: + type: object + properties: + name: + type: string + nullable: true + company: + type: string + nullable: true + street: + type: string + nullable: true + city: + type: string + nullable: true + state: + type: string + nullable: true + zip_code: + type: string + nullable: true + country_name: + type: string + nullable: true + country_code: + type: string + nullable: true + email_address: + type: string + format: email + nullable: true + phone: + type: string + nullable: true + fax: + type: string + nullable: true + mailing_address: + type: string + nullable: true + billing_contact: + type: object + properties: + name: + type: string + nullable: true + company: + type: string + nullable: true + street: + type: string + nullable: true + city: + type: string + nullable: true + state: + type: string + nullable: true + zip_code: + type: string + nullable: true + country_name: + type: string + nullable: true + country_code: + type: string + nullable: true + email_address: + type: string + format: email + nullable: true + phone: + type: string + nullable: true + fax: + type: string + nullable: true + mailing_address: + type: string + nullable: true + name_servers: + type: array + items: + type: string + domain_status: + type: array + items: + type: string + whois_raw_domain: + type: string + nullable: true + registry_data: + type: object + properties: + domain_name: + type: string + nullable: true + query_time: + type: string + format: date-time + nullable: true + whois_server: + type: string + nullable: true + domain_registered: + type: string + enum: + - 'yes' + - 'no' + - restricted + nullable: true + create_date: + type: string + format: date + nullable: true + update_date: + type: string + format: date + nullable: true + expiry_date: + type: string + format: date + nullable: true + name_servers: + type: array + items: + type: string + nullable: true + domain_status: + type: array + items: + type: string + nullable: true + whois_raw_registry: + type: string + nullable: true + domain_registrar: + type: object + properties: + iana_id: + type: string + nullable: true + registrar_name: + type: string + nullable: true + whois_server: + type: string + nullable: true + website_url: + type: string + format: uri + nullable: true + email_address: + type: string + format: email + nullable: true + phone_number: + type: string + nullable: true + WhoisHistoricalWHOISDefault: + type: object + required: + - num + - status + - domain_name + - query_time + - whois_server + - domain_registered + properties: + num: + type: integer + status: + type: boolean + domain_name: + type: string + query_time: + type: string + format: date-time + whois_server: + type: string + domain_registered: + type: string + enum: + - 'yes' + - 'no' + - restricted + create_date: + type: string + format: date + update_date: + type: string + format: date + expiry_date: + type: string + format: date + domain_registrar: + type: object + properties: + iana_id: + type: string + registrar_name: + type: string + whois_server: + type: string + website_url: + type: string + email_address: + type: string + phone_number: + type: string + reseller_contact: + type: object + properties: + name: + type: string + company: + type: string + street: + type: string + city: + type: string + state: + type: string + zip_code: + type: string + country_name: + type: string + country_code: + type: string + email_address: + type: string + phone: + type: string + fax: + type: string + mailing_address: + type: string + registrant_contact: + type: object + properties: + name: + type: string + company: + type: string + street: + type: string + city: + type: string + state: + type: string + zip_code: + type: string + country_name: + type: string + country_code: + type: string + email_address: + type: string + phone: + type: string + fax: + type: string + mailing_address: + type: string + administrative_contact: + type: object + properties: + name: + type: string + company: + type: string + street: + type: string + city: + type: string + state: + type: string + zip_code: + type: string + country_name: + type: string + country_code: + type: string + email_address: + type: string + phone: + type: string + fax: + type: string + mailing_address: + type: string + technical_contact: + type: object + properties: + name: + type: string + company: + type: string + street: + type: string + city: + type: string + state: + type: string + zip_code: + type: string + country_name: + type: string + country_code: + type: string + email_address: + type: string + phone: + type: string + fax: + type: string + mailing_address: + type: string + billing_contact: + type: object + properties: + name: + type: string + company: + type: string + street: + type: string + city: + type: string + state: + type: string + zip_code: + type: string + country_name: + type: string + country_code: + type: string + email_address: + type: string + phone: + type: string + fax: + type: string + mailing_address: + type: string + name_servers: + type: array + items: + type: string + domain_status: + type: array + items: + type: string + whois_raw_domain: + type: string + registry_data: + type: object + properties: + domain_name: + type: string + query_time: + type: string + format: date-time + whois_server: + type: string + domain_registered: + type: string + enum: + - 'yes' + - 'no' + - restricted + create_date: + type: string + format: date + update_date: + type: string + format: date + expiry_date: + type: string + format: date + name_servers: + type: array + items: + type: string + domain_status: + type: array + items: + type: string + whois_raw_registry: + type: string + domain_registrar: + type: object + properties: + iana_id: + type: string + registrar_name: + type: string + whois_server: + type: string + website_url: + type: string + email_address: + type: string + phone_number: + type: string + WhoisHistoricalWHOISMini: + type: object + required: + - num + - domain_name + properties: + num: + type: integer + domain_name: + type: string + create_date: + type: string + format: date + update_date: + type: string + format: date + expiry_date: + type: string + format: date + name: + type: string + email: + type: string + company_name: + type: string + WhoisIpWhoisResponse: + type: object + properties: + status: + type: boolean + description: Indicates if the WHOIS response from whois_server is a complete response + ip_address: + type: string + description: IP address (IPv4 or IPv6) to query live WHOIS + query_time: + type: string + format: date-time + description: Date and time of WHOIS query in the yyyy-MM-dd HH:mm:ss format + whois_server: + type: string + description: WHOIS host server used to query the ip_address + inet_nums: + type: array + items: + type: string + description: List of Internet Number resources (INETNUMs) related to the IP + irt: + type: object + properties: + handle: + type: string + description: Handle or unique identifier of this irt in the WHOIS data + address: + type: array + items: + type: string + description: List of addresses related to this irt + street: + type: string + description: Parsed street address from address + city: + type: string + description: Parsed city from address + district: + type: string + description: Parsed district from address + state: + type: string + description: Parsed state from address + zip_code: + type: string + description: Parsed ZIP code from address + country: + type: string + description: Parsed country from address + email: + type: array + items: + type: string + description: List of email addresses in the irt object + abuse_mailbox: + type: array + items: + type: string + description: List of abuse mailbox emails in the irt object + phone: + type: array + items: + type: string + description: List of phone numbers in the irt object + fax_no: + type: array + items: + type: string + description: List of fax numbers in the irt object + organizations: + type: array + items: + type: string + description: List of organizations related to this irt + admin_contacts: + type: array + items: + type: string + description: List of admin contacts related to this irt + tech_contacts: + type: array + items: + type: string + description: List of tech contacts related to this irt + remarks: + type: array + items: + type: string + description: List of remarks in the irt object + signature: + type: array + items: + type: string + description: List of signatures in the irt object + encryption: + type: array + items: + type: string + description: List of encryption values in the irt object + auth: + type: array + items: + type: string + description: List of auth values in the irt object + notify: + type: array + items: + type: string + description: List of notify values in the irt object + irt_nfy: + type: array + items: + type: string + description: List of irt-nfy values in the irt object + mnt_by: + type: array + items: + type: string + description: List of mnt-by values in the irt object + mnt_ref: + type: array + items: + type: string + description: List of mnt-ref values in the irt object + date_created: + type: string + format: date + description: This object's registration date + date_updated: + type: string + format: date + description: This object's last update date + source: + type: string + description: WHOIS data source of this object + organization: + type: object + properties: + handle: + type: string + description: Handle or unique identifier of this organization object in WHOIS data + name: + type: string + description: Name of the organization + type: + type: string + description: Type of the organization + description: + type: array + items: + type: string + description: List of descriptions related to the organization + address: + type: array + items: + type: string + description: List of addresses for the organization + street: + type: string + description: Parsed street address from organization address + city: + type: string + description: Parsed city from organization address + district: + type: string + description: Parsed district from organization address + state: + type: string + description: Parsed state from organization address + zip_code: + type: string + description: Parsed ZIP code from organization address + country: + type: string + description: Parsed country from organization address + latitude: + type: number + format: float + description: Latitude parsed from the geoloc field + longitude: + type: number + format: float + description: Longitude parsed from the geoloc field + email: + type: array + items: + type: string + description: List of email addresses in the organization object + abuse_mailbox: + type: array + items: + type: string + description: List of abuse mailbox emails in the organization object + phone: + type: array + items: + type: string + description: List of phone numbers in the organization object + fax_no: + type: array + items: + type: string + description: List of fax numbers in the organization object + admin_contacts: + type: array + items: + type: string + description: List of admin contacts related to this organization + tech_contacts: + type: array + items: + type: string + description: List of tech contacts related to this organization + abuse_contacts: + type: array + items: + type: string + description: List of abuse contacts related to this organization + remarks: + type: array + items: + type: string + description: List of remarks for this organization + notify: + type: array + items: + type: string + description: List of notify values in the organization object + ref_nfy: + type: array + items: + type: string + description: List of ref-nfy values in the organization object + mnt_by: + type: array + items: + type: string + description: List of mnt-by values in the organization object + mnt_ref: + type: array + items: + type: string + description: List of mnt-ref values in the organization object + date_created: + type: string + format: date + description: This object's registration date + date_updated: + type: string + format: date + description: This object's last update date + source: + type: string + description: WHOIS data source of this object + administrative_contacts: + type: array + items: + properties: + handle: + type: string + description: Unique identifier of the contact + name: + type: string + description: Name of the contact + email: + type: array + items: + type: string + description: List of email addresses for the contact + description: List of administrative contacts + technical_contacts: + type: array + items: + properties: + handle: + type: string + description: Unique identifier of the contact + name: + type: string + description: Name of the contact + email: + type: array + items: + type: string + description: List of email addresses for the contact + description: List of technical contacts + abuse_contacts: + type: array + items: + type: object + properties: + handle: + type: string + description: Unique identifier of the contact + name: + type: string + description: Name of the contact + email: + type: array + items: + type: string + description: List of email addresses for the contact + description: List of abuse contacts \ No newline at end of file diff --git a/docs/apifreaks.md b/docs/apifreaks.md new file mode 100644 index 0000000..0495f81 --- /dev/null +++ b/docs/apifreaks.md @@ -0,0 +1,41 @@ +# APIFreaks + +[APIFreaks](https://apifreaks.com) is an API hub for developers. This app exposes the +security-enrichment and geospatial endpoints most useful inside Shuffle workflows: +IP intelligence, WHOIS, DNS, SSL, domain, geocoding, GeoDB, timezone, user-agent +parsing, and astronomy — 43 actions in total. + +## Authentication + +All endpoints authenticate with an API key sent in the `X-apiKey` request header. +Get a free key at https://apifreaks.com/signup. + +- **Base URL:** `https://api.apifreaks.com` +- **Auth type:** API key (header `X-apiKey`) + +## Categories & actions + +| Category | Actions | Example use in a playbook | +| --- | --- | --- | +| IP Geolocation | 6 | Geolocate + risk-score an IP from a SIEM alert | +| WHOIS | 8 | Enrich a domain/IP/ASN observable; pull registrant + history | +| DNS | 4 | Resolve records, historical + reverse DNS on an indicator | +| SSL | 2 | Inspect a domain's certificate + full chain | +| Domain | 4 | Check availability; enumerate subdomains (attack surface) | +| GeoDB | 10 | Country/city/region reference data & flags | +| Geocoding | 2 | Forward/reverse geocoding for locations | +| Timezone | 3 | Resolve/convert timezone for a location or IP | +| User Agent | 2 | Parse a User-Agent string into device/OS/browser | +| Astronomy | 2 | Sunrise/sunset & astronomical data for a location | + +## Typical enrichment flow + +Suspicious IP → **IP Geolocation** (risk score, VPN/proxy/Tor/bot signals) → +**IP WHOIS + ASN** (network owner) → **reverse DNS / WHOIS** on the domain → +**SSL certificate** check → enrich the case in TheHive/MISP and alert the analyst. + +## Links + +- Website: https://apifreaks.com +- API docs / Swagger: https://apifreaks.com/api/swagger +- Sign up (free key): https://apifreaks.com/signup \ No newline at end of file