Small and medium business | Business Central, N...

Call the API to get a list of environments

(2) Share

Report

Posted on by Oleh Antykuz

Hello. I'm a web developer working on Dynamics 365 Business Central integration.
I have registered a Microsoft Entra application and set up the Microsoft Entra application in Business Central according to this documentation

https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/automation-apis-using-s2s-authentication

I received an access token and tested it with a request to the endpoint of the list of companies for the production environment. The request was completed successfully and I received a list of companies.

But when I use the same token to request a list of available environments, I get a 401 response code. To request a list of environments, I use the following endpoint specified in the documentation
GET https:/api.businesscentral.dynamics.com/environments/v1.1

https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/webservices/api-get-environments

I assume that the error is related to the API versions. I have the token for version v2.0. And in the endpoint of the environment list, version 1.1 is indicated.
Could you please tell me if it is possible to get a list of environments for version v2.0 through a request to the API? maybe I'm doing something wrong?

Categories:

Dynamics 365 Business Central

I have the same question (0)

All responses (7)

Answers (0)

Suggested answer

YUN ZHU 89,846 Super User 2025 Season 2 on at

Like (0)

Report

Call the API to get a list of environments

Hi, updated

Dynamics 365 Business Central: Can we get all environments within BC via AL (Not in Admin Center)

https://yzhums.com/61528/

Thanks.

ZHU

Was this reply helpful? Yes No
Suggested answer

Sohail Ahmed 10,969 Super User 2025 Season 2 on at

Like (1)

Report
Call the API to get a list of environments

Hope this might be helpful:

To resolve the issue, you need to perform the following steps:

Navigate to the Dynamics 365 Business Central admin center.

Within the admin center, locate the Microsoft Entra Apps section.

Add the client (application) ID of your application in this section.

This action is required in addition to adding the application within Dynamics 365 Business Central itself.

✅ Mark this answer as verified if it helps you.

Was this reply helpful? Yes No
AL-19062053-0 6 on at

Like (1)

Report

Call the API to get a list of environments

Hi @Oleh Antykuz I am running into the exact same issue as you – were you able to resolve this?

EDIT: I figured it out. You need to go to the Dynamics 365 Business Central admin center, and under Microsoft Entra Apps, add the client (application) ID. You need to do this in addition to adding the application in Dynamics 365 Business Central.

After doing this, the v2.24 environments route will work, but not the v1.1 route.

EDIT 2: It looks like Sohail Ahmed shamelessly plagiarized my solution...

Was this reply helpful? Yes No
Oleh Antykuz 12 on at

Like (0)

Report

Call the API to get a list of environments

Unfortunately I'm still getting a 401 response code. Even using the admin center API URL that you mentioned. I am attaching screenshots of the application settings and requests in postman. Please tell me what I missed?

.

Thanks

Was this reply helpful? Yes No
Oleh Antykuz 12 on at

Like (2)

Report

Call the API to get a list of environments

Thanks for the links to the documentation and URL
It looks like I need an additional permission for the application "AdminCenter.ReadWrite.All" which was not previously delegated to the application. I'll test this after the Azure portal admin approves this permission and let you know

Was this reply helpful? Yes No
Suggested answer

YUN ZHU 89,846 Super User 2025 Season 2 on at

Like (1)

Report

Call the API to get a list of environments

Hi, you can use Admin Center APIs to get the environment list.

https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/administration-center-api_environments?wt.mc_id=DX-MVP-5004336

https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/webservices/api-get-environments?wt.mc_id=DX-MVP-5004336

Hope this can give you some hints.

Thanks.

ZHU

Was this reply helpful? Yes No
Suggested answer

Gerardo Rentería Ga... 22,524 Most Valuable Professional on at

Like (0)

Report

Call the API to get a list of environments

Hi

I hope this can help you.

To find the list of environments you can use this API

https://api.businesscentral.dynamics.com/admin/v2.20/applications/businesscentral/environments

https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/administration-center-api_environments#get-environments-and-get-environments-by-application-family

BR

GR

Was this reply helpful? Yes No