Entra Tenant Information API

Created by Chris Greenacre, Modified on Fri, 3 Jan at 4:30 PM by Chris Greenacre

The API is available from this endpoint:

https://api.tophhie.cloud/tenantinfo


To utilise the API, you need one of the following:

  • The tenant ID
  • A domain name used within the tenant


Once you have either the tenant ID or the domain name, you're ready to use the API. Depending on which one of these you have, depends on the query parameter used.


If you have the tenant ID, specify "tenantID" as the query parameter:

  • https://api.tophhie.cloud/tenantinfo?tenantID={ENTRA ID TENANT ID}


If you have the domain name, specify "domainName" as the query parameter:

  • https://api.tophhie.cloud/tenantinfo?domainName={DOMAIN NAME}


Let's take the Microsoft tenant for example, to get information about the Microsoft tenant, you could use either of the following:

  • https://api.tophhie.cloud/tenantinfo?tenantID=72f988bf-86f1-41af-91ab-2d7cd011db47
  • https://api.tophhie.cloud/tenantinfo?domainName=microsoft.com


Once you call the API, you'll receive either a JSON object response (if the request is successful) or a standard text response with an error message.


The success response will always have a 200 status code.


The successful JSON object will look like:


{
    "tenantId": string,
    "federationBrandName": string or null,
    "tenantDisplayName": string,
    "defaultDomainName": string,
    "bannerLogo": string (may be empty),
    "tenantRegion": string,
    "desktopSsoEnabled": boolean,
    "verifiedEmailSignUpDisallowed": boolean or null,
    "tenantIsUnmanaged": boolean or null,
    "verifiedDomains": integer,
    "additionalDomains": [string]
}


Any status other than 200, means there was an error, and the text will indicate what the error was.


Try it and let us know what you think! If you run into any issues, you can reach out to our API support email address at api-support@tophhie.cloud.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article