# Including Subdomains

Adds subdomains with their own MX record on Cloudflare Email Routing: 2,777,768 records instead of 2,515,204, such as 0--o.cc.cd.

Source: https://docs.deepinfo.com/reference/discovery/reverse-mx/examples/include-subdomains/

Last updated: 2026-09-24

---
`GET https://api.deepinfo.com/v1/discovery/reverse-mx?ordering=punycode&mx=route1.mx.cloudflare.net&include_subdomains=true&page_size=25`

Adds subdomains with their own MX record on Cloudflare Email Routing: 2,777,768 records instead of 2,515,204, such as 0--o.cc.cd.

Example 2 of 2 in **Options** · [Reverse MX Examples](/reference/discovery/reverse-mx/examples/) · endpoint: [Reverse MX](/reference/discovery/reverse-mx/)

Tags: `param` `include_subdomains` · `param` `ordering` · `param` `mx` · `value` `true` · `value` `punycode` · `value` `route1.mx.cloudflare.net`

By default the API returns registrable domains only (`type: 1`). `include_subdomains=true` adds subdomains (`type: 2`) whose own MX record names the mail server.

The total grows from 2,515,204 to 2,777,768; the difference is subdomains. This example sorts by name (`ordering=punycode`), which puts a subdomain among the first records: `0--o.cc.cd` (`type: 2`, a subdomain of `cc.cd`) between two registrable domains. Its `subdomain` object describes the label (`0--o`), and `domain` holds `cc.cd`.

In the response, look at `result_count`, `results[].type`, `results[].subdomain` and `results[].dns.mx.mail_servers`.

## Request

| Parameter | In | Value |
|---|---|---|
| `ordering` | query | `punycode` |
| `mx` | query | `route1.mx.cloudflare.net` |
| `include_subdomains` | query | `true` |
| `page_size` | query | `25` |

```bash
curl 'https://api.deepinfo.com/v1/discovery/reverse-mx?ordering=punycode&mx=route1.mx.cloudflare.net&include_subdomains=true&page_size=25' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'
```

## Response

### 200 · OK

> Shortened for this page: results: 3 of 25 shown

`Content-Type: application/json` · `ratelimit-limit: 1` · `ratelimit-remaining: 0` · `ratelimit-reset: 1` · `x-ratelimit-limit-second: 1` · `x-ratelimit-remaining-second: 0` · `deepinfo-request-id: 5f0c6a8e-1b2d-4c3e-9f4a-7b8c9d0e1f2a`

```json
{
  "page": 1,
  "page_size": 25,
  "result_count": 2777768,
  "results": [
    {
      "punycode": "0--0----------------------------------------------------------0.ac",
      "unicode": "0--0----------------------------------------------------------0.ac",
      "is_idn": false,
      "subdomain": null,
      "subdomain_last": null,
      "subdomain_root": null,
      "name": {
        "punycode": "0--0----------------------------------------------------------0",
        "unicode": "0--0----------------------------------------------------------0",
        "is_idn": false,
        "contains_letter": false,
        "contains_number": true,
        "contains_hyphen": true,
        "length": 63,
        "lang": null,
        "keywords": [],
        "keyword_count": 0,
        "latinized": [],
        "contains_confusable": false
      },
      "domain": {
        "punycode": "0--0----------------------------------------------------------0.ac",
        "unicode": "0--0----------------------------------------------------------0.ac",
        "is_idn": false,
        "name": {
          "punycode": "0--0----------------------------------------------------------0",
          "unicode": "0--0----------------------------------------------------------0",
          "is_idn": false,
          "contains_letter": false,
          "contains_number": true,
          "contains_hyphen": true,
          "length": 63,
          "lang": null,
          "keywords": [],
          "keyword_count": 0
        },
        "extension": {
          "punycode": "ac",
          "unicode": "ac",
          "is_idn": false
        },
        "extension_root": {
          "punycode": "ac",
          "unicode": "ac",
          "is_idn": false
        },
        "extension_sub": null,
        "extension_type": 2,
        "reserved": null,
        "premium": null,
        "registered": true,
        "whois": {
          "create_date": "2025-12-09T01:59:47Z",
          "update_date": "2025-12-14T02:02:12Z",
          "expiry_date": "2031-12-09T01:59:47Z",
          "registrar": "namesilo, llc",
          "registrant": {
            "name": "see privacyguardian.org",
            "organization": "see privacyguardian.org",
            "street": "redacted",
            "city": "redacted",
            "state": "az",
            "postal_code": "redacted",
            "country": "us",
            "phone": "redacted",
            "email": "redacted"
          },
          "name_servers": [
            "indie.ns.cloudflare.com",
            "mitchell.ns.cloudflare.com"
          ],
          "domain_status": [
            "ok"
          ],
          "whois_server": "whois.namesilo.com",
          "check_date": "2026-06-27T07:55:58Z"
        },
        "whois_normalized": {
          "registrant": {
            "organization": "seeprivacyguardianorg",
            "phone": null,
            "email": null,
            "email_fqdn_apex": null,
            "email_domain_apex": null
          }
        },
        "whois_last_check_date": "2026-06-27T07:55:58Z",
        "whois_create_date_historical": [
          "2025-12-09T01:59:47Z"
        ],
        "whois_last_change_date": "2025-12-25T17:54:31Z",
        "whois_registrant_email_historical": [
          "redacted"
        ],
        "whois_privacy_enabled": true,
        "dns": {
          "a": {
            "update_date": "2026-09-12T18:35:57Z",
            "ip_addresses": []
          }
        },
        "dns_last_change_date": "2026-09-12T18:38:45Z",
        "ip_history": [],
        "ssl": null,
        "ssl_last_change_date": null
      },
      "type": 1,
      "subdomain_level_count": 0,
      "dns": {
        "a": {
          "update_date": "2026-09-12T18:35:57Z",
          "ip_addresses": []
        },
        "aaaa": {
          "update_date": "2026-09-12T18:35:57Z",
          "ip_addresses": []
        },
        "ns": {
          "update_date": "2026-09-12T18:35:57Z",
          "name_servers": [
            "indie.ns.cloudflare.com",
            "mitchell.ns.cloudflare.com"
          ]
        },
        "mx": {
          "update_date": "2026-09-12T18:35:57Z",
          "mail_servers": [
            "route1.mx.cloudflare.net",
            "route2.mx.cloudflare.net",
            "route3.mx.cloudflare.net"
          ]
        },
        "soa": {
          "update_date": "2026-09-12T18:35:57Z",
          "mnames": [
            "indie.ns.cloudflare.com"
          ],
          "rnames": [
            "dns.cloudflare.com"
          ],
          "rname_emails": [
            "user@cloudflare.com"
          ]
        },
        "txt": {
          "update_date": "2026-09-12T18:35:57Z",
          "values": [
            "\"v=spf1 include:_spf.mx.cloudflare.net ~all\""
          ]
        },
        "cname": {
          "update_date": "2026-09-12T18:35:57Z",
          "values": []
        },
        "others": []
      },
      "dns_last_change_date": "2026-09-12T18:38:43Z",
      "ip_history": [],
      "ssl": null,
      "ssl_last_change_date": null,
      "webdata": {
        "connection_status": "not_resolved",
        "html": null,
        "http": null
      }
    },
    {
      "punycode": "0--o.cc.cd",
      "unicode": "0--o.cc.cd",
      "is_idn": false,
      "subdomain": {
        "punycode": "0--o",
        "unicode": "0--o",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": true,
        "contains_hyphen": true,
        "length": 4
      },
      "subdomain_last": {
        "punycode": "0--o",
        "unicode": "0--o",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": true,
        "contains_hyphen": true,
        "length": 4
      },
      "subdomain_root": {
        "punycode": "0--o",
        "unicode": "0--o",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": true,
        "contains_hyphen": true,
        "length": 4
      },
      "name": {
        "punycode": "0--o.cc",
        "unicode": "0--o.cc",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": true,
        "contains_hyphen": true,
        "length": 6,
        "lang": "en",
        "keywords": [
          "occ"
        ],
        "keyword_count": 1,
        "latinized": [],
        "contains_confusable": false
      },
      "domain": {
        "punycode": "cc.cd",
        "unicode": "cc.cd",
        "is_idn": false,
        "name": {
          "punycode": "cc",
          "unicode": "cc",
          "is_idn": false,
          "contains_letter": true,
          "contains_number": false,
          "contains_hyphen": false,
          "length": 2,
          "lang": "fr",
          "keywords": [
            "cc"
          ],
          "keyword_count": 1
        },
        "extension": {
          "punycode": "cd",
          "unicode": "cd",
          "is_idn": false
        },
        "extension_root": {
          "punycode": "cd",
          "unicode": "cd",
          "is_idn": false
        },
        "extension_sub": null,
        "extension_type": 2,
        "reserved": null,
        "premium": null,
        "registered": null,
        "whois": null,
        "whois_normalized": null,
        "whois_last_check_date": null,
        "whois_create_date_historical": null,
        "whois_last_change_date": null,
        "whois_registrant_email_historical": null,
        "whois_privacy_enabled": null,
        "dns": {
          "a": {
            "update_date": "2026-09-08T01:31:15Z",
            "ip_addresses": [
              "47.128.150.127"
            ]
          }
        },
        "dns_last_change_date": "2026-09-08T01:34:45Z",
        "ip_history": null,
        "ssl": null,
        "ssl_last_change_date": null
      },
      "type": 2,
      "subdomain_level_count": 1,
      "dns": {
        "a": {
          "update_date": "2026-09-11T14:33:13Z",
          "ip_addresses": [
            "104.21.49.5",
            "172.67.139.251"
          ]
        },
        "aaaa": {
          "update_date": "2026-09-11T14:33:13Z",
          "ip_addresses": [
            "2606:4700:3034::ac43:8bfb",
            "2606:4700:3037::6815:3105"
          ]
        },
        "ns": {
          "update_date": "2026-09-11T14:33:13Z",
          "name_servers": [
            "jen.ns.cloudflare.com",
            "roman.ns.cloudflare.com"
          ]
        },
        "mx": {
          "update_date": "2026-09-11T14:33:13Z",
          "mail_servers": [
            "route1.mx.cloudflare.net",
            "route3.mx.cloudflare.net",
            "route2.mx.cloudflare.net"
          ]
        },
        "soa": {
          "update_date": "2026-09-11T14:33:13Z",
          "mnames": [
            "jen.ns.cloudflare.com"
          ],
          "rnames": [
            "dns.cloudflare.com"
          ],
          "rname_emails": [
            "user@cloudflare.com"
          ]
        },
        "txt": {
          "update_date": "2026-09-11T14:33:13Z",
          "values": [
            "\"v=DMARC1; p=none;\"",
            "\"v=spf1 include:_spf.mx.cloudflare.net ~all\""
          ]
        },
        "cname": {
          "update_date": "2026-09-11T14:33:13Z",
          "values": []
        },
        "others": []
      },
      "dns_last_change_date": "2026-09-11T21:09:40Z",
      "ip_history": [
        "104.21.49.5",
        "172.67.139.251"
      ],
      "ssl": {
        "tags": [
          "dla"
        ],
        "fqdns": [
          "0--o.cc.cd"
        ],
        "version": 3,
        "serial_number": "316545258355271710990438224859526617245",
        "fingerprint": {
          "sha256": "f9ca031ed93145ce908ce0b9803b81b21d4d87c96cee36ec8efd2293ed37037c",
          "sha1": "7eca2e73d8584677f2eb067b0c110f93911a8b25",
          "md5": "ed21802daa591444c17710cbf67d84be"
        },
        "validity": {
          "start_date": "2026-03-27T14:15:14Z",
          "end_date": "2026-06-25T15:15:11Z",
          "length": 7779597
        },
        "signature": {
          "is_self_signed": false,
          "is_valid": true,
          "value": "MEUCIQCf8sF+i5a9c/71Q7TOpmq7flJAGizk9Wvm0irAHPwj6AIgeiyiFZAZHhZ9rvX+8UZGQhBnYyeQlX7CNhvE0jDJrcw=",
          "algorithm": {
            "oid": "1.2.840.10045.4.3.2",
            "name": "sha256"
          }
        },
        "issuer_dn": "CN=WE1,O=Google Trust Services,C=US",
        "issuer": {
          "common_name": "WE1",
          "country": "US",
          "state": null,
          "locality": null,
          "organization": "Google Trust Services",
          "organizational_unit": null
        },
        "subject_dn": "CN=0--o.cc.cd",
        "subject": {
          "common_name": "0--o.cc.cd",
          "country": null,
          "state": null,
          "locality": null,
          "organization": null,
          "organizational_unit": null
        },
        "extensions": {
          "authority_key_id": "kHeSNWfE/6jMqeZ72YB5e8yT+Tg=",
          "basic_constraints": {
            "is_ca": false
          },
          "certificate_policies": [
            "2.23.140.1.2.1"
          ],
          "extended_key_usage": {
            "client_auth": null,
            "server_auth": true
          },
          "key_usage": {
            "digital_signature": true,
            "content_commitment": false,
            "key_agreement": false,
            "data_encipherment": false,
            "key_encipherment": false,
            "key_cert_sign": false,
            "crl_sign": false
          },
          "signed_certificate_timestamps": [
            "2026-03-27T15:15:14Z"
          ],
          "subject_alt_name": {
            "dns_names": [
              "0--o.cc.cd",
              "*.0--o.cc.cd"
            ]
          },
          "subject_key_id": "V+qw8Ww/3uAFcuDX7PfUFWwmoQE="
        },
        "check_date": "2026-03-29T05:52:49Z"
      },
      "ssl_last_change_date": "2026-03-29T05:53:14Z",
      "webdata": {
        "connection_status": "not_resolved",
        "html": null,
        "http": null
      }
    },
    {
      "punycode": "0-0-0-0.net",
      "unicode": "0-0-0-0.net",
      "is_idn": false,
      "subdomain": null,
      "subdomain_last": null,
      "subdomain_root": null,
      "name": {
        "punycode": "0-0-0-0",
        "unicode": "0-0-0-0",
        "is_idn": false,
        "contains_letter": false,
        "contains_number": true,
        "contains_hyphen": true,
        "length": 7,
        "lang": null,
        "keywords": [],
        "keyword_count": 0,
        "latinized": [],
        "contains_confusable": false
      },
      "domain": {
        "punycode": "0-0-0-0.net",
        "unicode": "0-0-0-0.net",
        "is_idn": false,
        "name": {
          "punycode": "0-0-0-0",
          "unicode": "0-0-0-0",
          "is_idn": false,
          "contains_letter": false,
          "contains_number": true,
          "contains_hyphen": true,
          "length": 7,
          "lang": null,
          "keywords": [],
          "keyword_count": 0
        },
        "extension": {
          "punycode": "net",
          "unicode": "net",
          "is_idn": false
        },
        "extension_root": {
          "punycode": "net",
          "unicode": "net",
          "is_idn": false
        },
        "extension_sub": null,
        "extension_type": 1,
        "reserved": null,
        "premium": null,
        "registered": true,
        "whois": {
          "create_date": "2025-07-12T04:56:03Z",
          "update_date": "2026-06-12T04:25:02Z",
          "expiry_date": "2027-07-12T04:56:03Z",
          "registrar": "cloudflare, inc.",
          "registrant": {
            "name": "REDACTED FOR PRIVACY",
            "organization": null,
            "street": "REDACTED FOR PRIVACY",
            "city": "data redacted",
            "state": "ut",
            "postal_code": "REDACTED FOR PRIVACY",
            "country": "us",
            "phone": "REDACTED FOR PRIVACY",
            "email": null
          },
          "name_servers": [
            "katja.ns.cloudflare.com",
            "scott.ns.cloudflare.com"
          ],
          "domain_status": [
            "clienttransferprohibited"
          ],
          "whois_server": "whois.cloudflare.com",
          "check_date": "2026-08-19T20:57:53Z"
        },
        "whois_normalized": {
          "registrant": {
            "organization": null,
            "phone": "REDACTED FOR PRIVACY",
            "email": null,
            "email_fqdn_apex": null,
            "email_domain_apex": null
          }
        },
        "whois_last_check_date": "2026-08-19T20:57:53Z",
        "whois_create_date_historical": [
          "2021-06-25T09:23:53Z",
          "2025-07-12T04:56:03Z"
        ],
        "whois_last_change_date": "2026-06-20T18:02:48Z",
        "whois_registrant_email_historical": [
          "user@aol.com",
          "user@whoisprivacyguardservice.com",
          "redacted for privacy",
          "https://domaincontact.cloudflareregistrar.com/0-0-0-0.net",
          "https://domaincontact.registrar.cloudflare.com/0-0-0-0.net"
        ],
        "whois_privacy_enabled": true,
        "dns": {
          "a": {
            "update_date": "2026-09-09T09:42:27Z",
            "ip_addresses": []
          }
        },
        "dns_last_change_date": "2026-09-09T09:46:38Z",
        "ip_history": [
          "150.95.59.11",
          "150.95.59.16",
          "72.52.178.23"
        ],
        "ssl": {
          "validity": {
            "start_date": "2021-11-24T00:00:00Z",
            "end_date": "2022-02-22T23:59:59Z"
          },
          "serial_number": "128039638368136240265859208033079428278",
          "check_date": "2021-12-07T13:23:48Z"
        },
        "ssl_last_change_date": "2023-08-07T03:57:29Z"
      },
      "type": 1,
      "subdomain_level_count": 0,
      "dns": {
        "a": {
          "update_date": "2026-09-09T09:42:27Z",
          "ip_addresses": []
        },
        "aaaa": {
          "update_date": "2026-09-09T09:42:27Z",
          "ip_addresses": []
        },
        "ns": {
          "update_date": "2026-09-09T09:42:27Z",
          "name_servers": [
            "katja.ns.cloudflare.com",
            "scott.ns.cloudflare.com"
          ]
        },
        "mx": {
          "update_date": "2026-09-09T09:42:27Z",
          "mail_servers": [
            "route2.mx.cloudflare.net",
            "route3.mx.cloudflare.net",
            "route1.mx.cloudflare.net"
          ]
        },
        "soa": {
          "update_date": "2026-09-09T09:42:27Z",
          "mnames": [
            "katja.ns.cloudflare.com"
          ],
          "rnames": [
            "dns.cloudflare.com"
          ],
          "rname_emails": [
            "user@cloudflare.com"
          ]
        },
        "txt": {
          "update_date": "2026-09-09T09:42:27Z",
          "values": [
            "\"v=spf1 include:_spf.mx.cloudflare.net ~all\""
          ]
        },
        "cname": {
          "update_date": "2026-09-09T09:42:27Z",
          "values": []
        },
        "others": []
      },
      "dns_last_change_date": "2026-09-09T09:46:37Z",
      "ip_history": [
        "150.95.59.11",
        "150.95.59.16",
        "72.52.178.23"
      ],
      "ssl": {
        "tags": [],
        "fqdns": [
          "0-0-0-0.net",
          "cpanel.0-0-0-0.net",
          "cpcalendars.0-0-0-0.net",
          "cpcontacts.0-0-0-0.net",
          "mail.0-0-0-0.net",
          "webdisk.0-0-0-0.net",
          "webmail.0-0-0-0.net",
          "www.0-0-0-0.net"
        ],
        "version": 3,
        "serial_number": "128039638368136240265859208033079428278",
        "fingerprint": {
          "sha256": "f8013c10f459488877be5e4f92c95572ef32eb87de39468ccc8f5b296c247bdd",
          "sha1": "c1eec016056f5cac12fae2770b0037bb1ab2189e",
          "md5": "755a2f0b95e3445c690d15446b8f169a"
        },
        "validity": {
          "start_date": "2021-11-24T00:00:00Z",
          "end_date": "2022-02-22T23:59:59Z",
          "length": 7862399
        },
        "signature": {
          "is_self_signed": false,
          "is_valid": true,
          "value": "GewOgwEvMTnid5O+OwjjLjZ1/DfwdgphDYBUNGbaoi5JeGESRzqeKz1srANTdzyWYFf3uOu+OqJ3cPKi0YfrRiggUBNOdKHBMyooi/e3j+L4A6MSoF5O+HMt7pTTI5YqGhxjiTtlpZQw+rmz7Jl8T+qSxozH2f5lgjm5dvvXqW8G8Q4uu6IrkkyB8vE+64AwFcSkf5vVmUlYvIeipZlCa/EWTQ3azKmXIJgIC6Ae6F5dOvIvGp2NInSs7pFEGPSenohmJsZthUZUTh0HqvDZNFDL+brb7F5ygsjgFfdqUycp+/rNqqh6WLiq9nwL2e3zghi2716Mf1wtOm4nytNZeQ==",
          "algorithm": {
            "oid": "1.2.840.113549.1.1.11",
            "name": "sha256"
          }
        },
        "issuer_dn": "CN=cPanel\\, Inc. Certification Authority,O=cPanel\\, Inc.,L=Houston,ST=TX,C=US",
        "issuer": {
          "common_name": "cPanel, Inc. Certification Authority",
          "country": "US",
          "state": "TX",
          "locality": "Houston",
          "organization": "cPanel, Inc.",
          "organizational_unit": null
        },
        "subject_dn": "CN=0-0-0-0.net",
        "subject": {
          "common_name": "0-0-0-0.net",
          "country": null,
          "state": null,
          "locality": null,
          "organization": null,
          "organizational_unit": null
        },
        "extensions": {
          "authority_key_id": "fgNaZUFrp34K4bidCOodjh1qx2U=",
          "basic_constraints": {
            "is_ca": false
          },
          "certificate_policies": [
            "1.3.6.1.4.1.6449.1.2.2.52",
            "2.23.140.1.2.1"
          ],
          "extended_key_usage": {
            "client_auth": true,
            "server_auth": true
          },
          "key_usage": {
            "digital_signature": true,
            "content_commitment": false,
            "key_agreement": false,
            "data_encipherment": false,
            "key_encipherment": true,
            "key_cert_sign": false,
            "crl_sign": false
          },
          "signed_certificate_timestamps": [
            "2021-11-24T18:15:15Z"
          ],
          "subject_alt_name": {
            "dns_names": [
              "0-0-0-0.net",
              "cpanel.0-0-0-0.net",
              "cpcalendars.0-0-0-0.net",
              "cpcontacts.0-0-0-0.net",
              "mail.0-0-0-0.net",
              "webdisk.0-0-0-0.net",
              "webmail.0-0-0-0.net",
              "www.0-0-0-0.net"
            ]
          },
          "subject_key_id": "c179TDzRzy1Ghu35r+G73+Kqnbg="
        },
        "check_date": "2021-12-07T13:23:48Z"
      },
      "ssl_last_change_date": "2023-08-07T03:57:29Z",
      "webdata": {
        "connection_status": "not_resolved",
        "html": null,
        "http": null
      }
    }
  ]
}
```

## Related Examples

- [Earliest Expiry First](/reference/discovery/reverse-mx/examples/ordering-expiry-date/)
- [Any Mail Server Under the Same Domain](/reference/discovery/reverse-mx/examples/apex/)
- [Domains Using Cloudflare Email Routing](/reference/discovery/reverse-mx/examples/cloudflare-email-routing/)
- [Second Page of Results](/reference/discovery/reverse-mx/examples/second-page/)
- [Larger Pages (100 Results)](/reference/discovery/reverse-mx/examples/page-size-100/)
- [Domains Using One Mail Server](/reference/discovery/reverse-mx/examples/mail-server/)
