Understanding endpoints in the Microsoft Dynamics 365 Business Central v2 API

Learn about endpoints in the Microsoft Dynamics 365 Business Central v2 API, which enable secure and structured access to data and functions via the API.

6 February 2025 · 3 min read

Dynamics 365 Business Central API v2 endpoints

What is an endpoint?

An endpoint in the Microsoft Dynamics 365 Business Central v2 API is a specific URL that acts as an access point to particular functions or data in Business Central. These endpoints make programmatic interaction with the Business Central system possible and are often used by developers to build integrations and custom applications.

The structure of Business Central v2 API endpoints

Business Central v2 API endpoints follow a fixed structure, which makes them easy to find and use. The general URL structure looks like this:

https://api.businesscentral.dynamics.com/v2.0/<miljønavn>/api/v2.0/

Here <miljønavn> represents the specific environment being used, for example “production” (the production environment) or “sandbox” (the test environment).

Types of endpoints in Business Central

Microsoft Dynamics 365 Business Central offers several different types of endpoints depending on how you want to interact with the system:

1. Common Endpoint Service

This is the most commonly used endpoint and is used for general operations in Business Central.

https://api.businesscentral.dynamics.com/v2.0/<miljønavn>/api/v2.0

2. Direct Tenant Endpoint

This endpoint gives direct access to a specific tenant. It is useful when working with tenant-specific data.

https://api.businesscentral.dynamics.com/v2.0/<brugerdomænenavn>/<miljønavn>/api/v2.0

3. Microsoft Graph Endpoint

This endpoint is used to integrate Business Central with other Microsoft services via the Microsoft Graph API.

https://graph.microsoft.com/beta/financials/

Microsoft Graph endpoints make it possible to connect data and functions across several Microsoft solutions, which can increase the usefulness of and the coherence between different systems.

Using endpoints

To use Business Central API endpoints there are several steps to follow:

1. Authentication

Endpoints require secure access, and that happens through authentication using OAuth 2.0. This ensures that only authorised users and applications can access data.

2. HTTP requests

Communication with endpoints happens through HTTP requests. The most commonly used types of request are:

GET: Retrieve data from Business Central.
POST: Create new data.
PUT: Update existing data.
DELETE: Delete data.

3. Data handling

All responses from the API are delivered in JSON format, which is a lightweight format for data exchange. Developers have to be able to parse and handle these responses in order to extract or manipulate data correctly.

Benefits of endpoints

Business Central endpoints provide a number of benefits:

Flexibility: The ability to tailor integrations to specific needs.
Security: Data transfer takes place through secure protocols and access control.
Efficiency: Automation of data handling and processes.
Integration: Easy integration with other Microsoft services such as Microsoft Teams, Power BI and SharePoint.

Endpoints for integrations

Endpoints in the Microsoft Dynamics 365 Business Central v2 API are a decisive component for developers working with integrations and custom applications. By making use of the different endpoint types and following the necessary steps for authentication and data handling, you can achieve streamlined and secure access to Business Central data and functions. This makes efficient data exchange possible and improves the company’s digital workflows.

Business Central API v2.0 Documentation

Here is a comprehensive guide to integrating and handling data in Microsoft Dynamics 365 Business Central via secure and structured API endpoints.