Entra ID Tenant Information API Updates 🌐

Yesterday (28th April 2025), I deployed some updates to the Tophhie Cloud API. Most of these updates were small bug fixes, performance enhancements, and general housekeeping.

However, the Entra ID Tenant Information API got a couple significant updates.

Let's go through them.

Two New Query Parameters

I've introduced two new query parameters into the API, both with the sole purpose of improving responsiveness and for allowing some more customisation over the data that is returned.

customDomainsOnly (Boolean)

By default, this value is "false". However, when set to "true" this tells the API to skip over the ".onmicrosoft.com" domains when performing the email configuration lookups.

I've found people aren't too bothered about returning the MX records and some Exchange configuration for the onmicrosoft.com domains, they're set up by default, managed by Microsoft, and always configured correctly. Therefore, I'm providing the option to skip the lookup of these domains.

If set to "true", only custom domains will be analysed.

Example:

https://api.tophhie.cloud/entra/tenantinfo?domainname=tophhie.cloud&customdomainsonly=true

skipEmailConfig (Boolean)

Again, by default, this value is "false". But when set to "true" this tells the API to completely skip all email configuration and MX record checks.

The email configuration and MX record checks are by far the largest of the queries and take the longest time to respond, therefore slowing down the API's overall response for all the information.

I'm now giving people the option to completely skip this check.

If set to "true", the emailConfiguration and mxRecords array will return empty. (Because there's been no checks, and therefore no data).

Example:

https://api.tophhie.cloud/entra/tenantinfo?domainname=tophhie.cloud&skipemailconfig=true

Updated Response Object

Recent changes to the API haven't been as publicly documented as I would have liked. However, with the introduction of the Tophhie Cloud API Docs you can now keep up to date with all model changes, new API releases, and API changes. Significant updates will still be posted here, but for live up to date information, the docs are where you'll find them.

With that in mind, I'm going to post here the latest version (as of 29th April 2025) of the Entra ID Tenant Information API Response Model.

{
  "tenantId": "string",
  "federationBrandName": "string",
  "tenantDisplayName": "string",
  "defaultDomainName": "string",
  "bannerLogo": "string",
  "tenantRegion": "string",
  "desktopSsoEnabled": true,
  "verifiedEmailSignUpDisallowed": true,
  "tenantIsUnmanaged": true,
  "tenantLeaveUrl": "string",
  "tenantUsesExo": true,
  "mxRecords": [
    "string"
  ],
  "emailConfiguration": [
    {
      "domain": "string",
      "mxRecords": [
        "string"
      ],
      "exoSmtpDaneDnsSecEnabled": true
    }
  ],
  "tenantUsesSpo": true,
  "spoDomains": [
    "string"
  ],
  "verifiedDomains": 0,
  "additionalDomains": [
    "string"
  ]
}

🔗 Feel free to check out the Tophhie Cloud API Docs here.
🔗 Here's the link to the Entra ID Tenant Information API overview.

Until next time 👋