{"title":"Endpoints for the APIs for Dynamics 365 Business Central On-Premises and Online","url":"https://jonas-paprotka.de/docs/dev-itpro/api-reference/v2.0/endpoints-apis-for-dynamics/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v2.0/endpoints-apis-for-dynamics, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v2.0/endpoints-apis-for-dynamics","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Describes the steps you must go through to enable access to the APIs in on-prem and cloud product versions.","date":"2026-02-16","meta":{"topic":"article"},"outline":[{"level":1,"title":"Endpoints for the APIs for Dynamics 365 Business Central On-Premises and Online","slug":"endpoints-for-the-apis-for-dynamics-365-business-central-on-premises-and-online","at":0,"chars":4117},{"level":2,"title":"Accessing the endpoints","slug":"accessing-the-endpoints","at":405,"chars":3097},{"level":3,"title":"Business Central","slug":"business-central","at":1192,"chars":1273},{"level":3,"title":"Business Central On-Premises","slug":"business-central-on-premises","at":2465,"chars":1037},{"level":2,"title":"Which IP addresses or ranges does my environment's API use?","slug":"which-ip-addresses-or-ranges-does-my-environments-api-use","at":3502,"chars":344},{"level":2,"title":"Related information","slug":"related-information","at":3846,"chars":271}],"text":"# Endpoints for the APIs for Dynamics 365 Business Central On-Premises and Online\nBusiness Central on-premises and online expose an API that makes it possible to integrate with other services. To enable integration with these APIs, you must go through a few steps to enable the access first. Learn more about these steps in Enabling APIs for Dynamics 365 Business Central<enabling-apis-for-dynamics-nav>.\n## Accessing the endpoints\nOnce you have the API access enabled, you can write code that integrates your web service or SaaS solution with Business Central. Creating your integration through an API provides simple access to the supported functionality in a single endpoint, giving you a simplified experience for creating a single app with integrations across multiple Microsoft products. Learn more about the structure of the API endpoints in ../../webservices/api-endpoint-structure.\n> IMPORTANT\n> With the introduction of multiple Business Central environments, the name of the environment being connected to needs to go into the URI. Learn more about how to get a list of environments deployed on the tenant in Getting a list of environments<../../webservices/api-get-environments>.\n### Business Central\nMeans of connection|Microsoft Graph|Common endpoint service|Direct tenant\n--|--|--|--\nUsage|Production|Production|Production\nEndpoint|`https://`<br>graph.microsoft.com<br>`/beta/financials/`|`https://`<br>`api.businesscentral.dynamics.com/`<br> `v2.0/<environment name>/api/v2.0` <br><br> Example:<br> `https://`<br>`api.businesscentral.dynamics.com/`<br> `v2.0/production/api/v2.0`|`https://`<br>`api.businesscentral.dynamics.com/`<br>`v2.0/<user domain name>/<environment name>/api/v2.0`<br><br> Example:<br> `https://`<br>`api.businesscentral.dynamics.com/`<br> `v2.0/cronus.com/sandbox/api/v2.0`\nAvailability|Always enabled|Always enabled|Always enabled\nAuthentication|Microsoft Entra ID<br>|Microsoft Entra ID<br>|Microsoft Entra ID<br>\nAPI/Data access|Based on user's<br> ../../developer/devenv-permissions-on-database-objects|Based on user's<br> ../../developer/devenv-permissions-on-database-objects|Based on user's<br> ../../developer/devenv-permissions-on-database-objects\nAPI update cycle|Monthly|Monthly|Monthly\nDevelopment instance|Sign up for a tenant<https://go.microsoft.com/fwlink/?linkid=847861>|Sign up for a tenant<https://go.microsoft.com/fwlink/?linkid=847861>|Sign up for a tenant<https://go.microsoft.com/fwlink/?linkid=847861>\n### Business Central On-Premises\nMeans of connection|Direct installation\nUsage|Production\nEndpoint|OData base URL in installation: <br> `https://`<br>`<base URL>:<port>/<serverInstance>/api/<API version>/` <br> Example: `https://`<br>`nav.contoso.com:7048/`<br>`bc/api/v2.0` <br> Must be exposed through a firewall.<br><br>Extension APIs:<br>`https://<base URL>:<port>/<serverinstance>/api/<API publisher>/<API group>/<API version>`\nAvailability|Disabled by default.<br> Must be enabled by the administrator.\nAuthentication|Basic authentication.<br> Username and web service<br> access key<../../developer/devenv-develop-connect-apps> as password. Your solution must be configured to use NavUserPassword or AccessControlService authentication in order to configure Business Central user accounts to include an access key.\nAPI/Data access|Based on user's<br> ../../developer/devenv-permissions-on-database-objects\nAPI update cycle|Hotfixes installed by partner\nDevelopment instance|Get Docker<https://aka.ms/navdeveloperpreview> instance\n## Which IP addresses or ranges does my environment's API use?\nWhen you exchange data through the API, you might have to safelist the IP addresses.\nSee FAQ: IP addresses or ranges for the Business Central service<https://learn.microsoft.com/dynamics365/business-central/dev-itpro/faq#which-ip-addresses-or-ranges-does-my-environment-s-api-use>\n## Related information\nDeveloping Connect apps for Dynamics 365 Business Central<../../developer/devenv-develop-connect-apps>\nMicrosoft web services overview<../../webservices/web-services>\nOpenAPI specification<dynamics-open-api>\n../../webservices/api-endpoint-structure"}