API
/
Microsoft Dynamics 365 Business Central API
/
Microsoft Dynamics 365 Business Central ODATA API - Default built by Microsoft
/
Business Central Company API
/
Retrieve the properties and relationships of an object of type company for Dynamics 365 Business Central.

Dynamics 365 Business Central API (1.0)

Dynamics 365 Business Central is a comprehensive business management solution developed by Microsoft. It is designed for small to medium-sized businesses to streamline operations across finance, sales, service, and supply chain. With powerful capabilities and cloud-based flexibility, it helps businesses make informed decisions and drive growth efficiently.

This is a complete REST API documentation for integrating with Dynamics 365 Business Central. It includes standard endpoints provided by Microsoft for managing business data and operations.

Metadata

KeyValue
releaseDate10 Apr 2025
keywordDynamics 365 Business Central API
Download OpenAPI description
docs.json
docs.yaml
Languages
Servers
Mock server
https://docs.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/microsoft-dynamics-365-business-central-odata-api---default-built-by-microsoft/docs/
https://api.businesscentral.dynamics.com/v2.0/Production/api/v2.0/
https://login.microsoftonline.com/

Business Central Get Access Token API

To obtain an access token, you cannot directly call it through a web UI. Instead, use Postman to make the request. Below is a sample request that you can follow to retrieve your access token:

Operations

Business Central Entity API

(v1.0) Represents all Entities in Dynamics 365 Business Central

Operations

Business Central Company API

(v1.0) Represents an object of type company in Dynamics 365 Business Central

Operations

Returns a list of companies

Request

Query
$topinteger

(v1.0) Number of items to return from the top of the list

Example: $top=100
$skipinteger

(v1.0) Number of items to skip from the list

Example: $skip=0
$limitinteger

(v1.0) Number of items to return from the list

Example: $limit=100
$filterstring

(v1.0) Filtering expression

$selectArray of strings

(v1.0) Selected properties to be retrieved

Items Enum"id""systemVersion""name""displayName""businessProfileId"
curl -i -X GET \
  'https://docs.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/microsoft-dynamics-365-business-central-odata-api---default-built-by-microsoft/docs/companies?%24filter=string&%24limit=100&%24select=id&%24skip=0&%24top=100' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

(v1.0) Succesfully returned a list of companies

Bodyapplication/json
valueArray of objects(company)
Response
application/json
{
  "value": [
    { … }
  ]
}

Retrieve the properties and relationships of an object of type company for Dynamics 365 Business Central.

Request

Path
company_idstring(uuid)required

(v1.0) id for company

Example: 1fd2400b-59f8-48b7-877e-c767e8779627
Query
$selectArray of strings

(v1.0) Selected properties to be retrieved

Items Enum"id""systemVersion""name""displayName""businessProfileId"
curl -i -X GET \
  'https://docs.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/microsoft-dynamics-365-business-central-odata-api---default-built-by-microsoft/docs/companies(1fd2400b-59f8-48b7-877e-c767e8779627)?%24select=id' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

(v1.0) Succesfully returned the requested company

Bodyapplication/json
idstring(uuid)

(v1.0) The id property for the Dynamics 365 Business Central company entity

Example: "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4"
systemVersionstring or null

(v1.0) The systemVersion property for the Dynamics 365 Business Central company entity

Example: null
namestring or null<= 30 characters

(v1.0) The name property for the Dynamics 365 Business Central company entity

Example: null
displayNamestring or null<= 250 characters

(v1.0) The displayName property for the Dynamics 365 Business Central company entity

Example: null
businessProfileIdstring or null<= 250 characters

(v1.0) The businessProfileId property for the Dynamics 365 Business Central company entity

Example: null
itemsArray of objects or null(item)
pictureArray of objects or null(picture)
defaultDimensionsArray of objects or null(defaultDimensions)
customersArray of objects or null(customer)
customerFinancialDetailsArray of objects or null(customerFinancialDetail)
vendorsArray of objects or null(vendor)
companyInformationArray of objects or null(companyInformation)
salesInvoicesArray of objects or null(salesInvoice)
salesInvoiceLinesArray of objects or null(salesInvoiceLine)
pdfDocumentArray of objects or null(pdfDocument)
customerPaymentJournalsArray of objects or null(customerPaymentJournal)
customerPaymentsArray of objects or null(customerPayment)
accountsArray of objects or null(account)
taxGroupsArray of objects or null(taxGroup)
journalsArray of objects or null(journal)
journalLinesArray of objects or null(journalLine)
attachmentsArray of objects or null(attachments)
employeesArray of objects or null(employee)
timeRegistrationEntriesArray of objects or null(timeRegistrationEntry)
generalLedgerEntriesArray of objects or null(generalLedgerEntry)
currenciesArray of objects or null(currency)
paymentMethodsArray of objects or null(paymentMethod)
dimensionsArray of objects or null(dimension)
dimensionValuesArray of objects or null(dimensionValue)
dimensionLinesArray of objects or null(dimensionLine)
paymentTermsArray of objects or null(paymentTerm)
shipmentMethodsArray of objects or null(shipmentMethod)
itemCategoriesArray of objects or null(itemCategory)
cashFlowStatementArray of objects or null(cashFlowStatement)
countriesRegionsArray of objects or null(countryRegion)
salesOrdersArray of objects or null(salesOrder)
salesOrderLinesArray of objects or null(salesOrderLine)
retainedEarningsStatementArray of objects or null(retainedEarningsStatement)
unitsOfMeasureArray of objects or null(unitOfMeasure)
agedAccountsReceivableArray of objects or null(agedAccountsReceivable)
agedAccountsPayableArray of objects or null(agedAccountsPayable)
balanceSheetArray of objects or null(balanceSheet)
trialBalanceArray of objects or null(trialBalance)
incomeStatementArray of objects or null(incomeStatement)
taxAreasArray of objects or null(taxArea)
salesQuotesArray of objects or null(salesQuote)
salesQuoteLinesArray of objects or null(salesQuoteLine)
salesCreditMemosArray of objects or null(salesCreditMemo)
salesCreditMemoLinesArray of objects or null(salesCreditMemoLine)
generalLedgerEntryAttachmentsArray of objects or null(generalLedgerEntryAttachments)
purchaseInvoicesArray of objects or null(purchaseInvoice)
purchaseInvoiceLinesArray of objects or null(purchaseInvoiceLine)
projectsArray of objects or null(project)
bankAccountsArray of objects or null(bankAccount)
customerSalesArray of objects or null(customerSale)
vendorPurchasesArray of objects or null(vendorPurchase)
Response
application/json
{
  "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
  "systemVersion": null,
  "name": null,
  "displayName": null,
  "businessProfileId": null,
  "items": [
    { … }
  ],
  "picture": [
    { … }
  ],
  "defaultDimensions": [
    { … }
  ],
  "customers": [
    { … }
  ],
  "customerFinancialDetails": [
    { … }
  ],
  "vendors": [
    { … }
  ],
  "companyInformation": [
    { … }
  ],
  "salesInvoices": [
    { … }
  ],
  "salesInvoiceLines": [
    { … }
  ],
  "pdfDocument": [
    { … }
  ],
  "customerPaymentJournals": [
    { … }
  ],
  "customerPayments": [
    { … }
  ],
  "accounts": [
    { … }
  ],
  "taxGroups": [
    { … }
  ],
  "journals": [
    { … }
  ],
  "journalLines": [
    { … }
  ],
  "attachments": [
    { … }
  ],
  "employees": [
    { … }
  ],
  "timeRegistrationEntries": [
    { … }
  ],
  "generalLedgerEntries": [
    { … }
  ],
  "currencies": [
    { … }
  ],
  "paymentMethods": [
    { … }
  ],
  "dimensions": [
    { … }
  ],
  "dimensionValues": [
    { … }
  ],
  "dimensionLines": [
    { … }
  ],
  "paymentTerms": [
    { … }
  ],
  "shipmentMethods": [
    { … }
  ],
  "itemCategories": [
    { … }
  ],
  "cashFlowStatement": [
    { … }
  ],
  "countriesRegions": [
    { … }
  ],
  "salesOrders": [
    { … }
  ],
  "salesOrderLines": [
    { … }
  ],
  "retainedEarningsStatement": [
    { … }
  ],
  "unitsOfMeasure": [
    { … }
  ],
  "agedAccountsReceivable": [
    { … }
  ],
  "agedAccountsPayable": [
    { … }
  ],
  "balanceSheet": [
    { … }
  ],
  "trialBalance": [
    { … }
  ],
  "incomeStatement": [
    { … }
  ],
  "taxAreas": [
    { … }
  ],
  "salesQuotes": [
    { … }
  ],
  "salesQuoteLines": [
    { … }
  ],
  "salesCreditMemos": [
    { … }
  ],
  "salesCreditMemoLines": [
    { … }
  ],
  "generalLedgerEntryAttachments": [
    { … }
  ],
  "purchaseInvoices": [
    { … }
  ],
  "purchaseInvoiceLines": [
    { … }
  ],
  "projects": [
    { … }
  ],
  "bankAccounts": [
    { … }
  ],
  "customerSales": [
    { … }
  ],
  "vendorPurchases": [
    { … }
  ]
}

Business Central Item API

(v1.0) Represents an object of type item in Dynamics 365 Business Central

Operations

Business Central Picture API

(v1.0) Represents an object of type picture in Dynamics 365 Business Central

Operations

Business Central Default Dimensions API

(v1.0) Represents an object of type defaultDimensions in Dynamics 365 Business Central

Operations

Business Central Customer API

(v1.0) Represents an object of type customer in Dynamics 365 Business Central

Operations

Business Central Customer Financial Detail API

(v1.0) Represents an object of type customerFinancialDetail in Dynamics 365 Business Central

Operations

Business Central Vendor API

(v1.0) Represents an object of type vendor in Dynamics 365 Business Central

Operations

Business Central Company Information API

(v1.0) Represents an object of type companyInformation in Dynamics 365 Business Central

Operations

Business Central Sales Invoice API

(v1.0) Represents an object of type salesInvoice in Dynamics 365 Business Central

Operations

Business Central Sales Invoice Line API

(v1.0) Represents an object of type salesInvoiceLine in Dynamics 365 Business Central

Business Central PDF Document API

(v1.0) Represents an object of type pdfDocument in Dynamics 365 Business Central

Operations

Business Central Customer Payment Journal API

(v1.0) Represents an object of type customerPaymentJournal in Dynamics 365 Business Central

Business Central Customer Payment API

(v1.0) Represents an object of type customerPayment in Dynamics 365 Business Central

Business Central Account API

(v1.0) Represents an object of type account in Dynamics 365 Business Central

Operations

Business Central Tax Group API

(v1.0) Represents an object of type taxGroup in Dynamics 365 Business Central

Operations

Business Central Journal API

(v1.0) Represents an object of type journal in Dynamics 365 Business Central

Operations

Business Central Journal Line API

(v1.0) Represents an object of type journalLine in Dynamics 365 Business Central

Business Central Attachments API

(v1.0) Represents an object of type attachments in Dynamics 365 Business Central

Operations

Business Central Employee API

(v1.0) Represents an object of type employee in Dynamics 365 Business Central

Operations

Business Central Time Registration Entry API

(v1.0) Represents an object of type timeRegistrationEntry in Dynamics 365 Business Central

Business Central General Ledger Entry API

(v1.0) Represents an object of type generalLedgerEntry in Dynamics 365 Business Central

Operations

Business Central Currency API

(v1.0) Represents an object of type currency in Dynamics 365 Business Central

Operations

Business Central Payment Method API

(v1.0) Represents an object of type paymentMethod in Dynamics 365 Business Central

Operations

Business Central Dimension API

(v1.0) Represents an object of type dimension in Dynamics 365 Business Central

Operations

Business Central Dimension Value API

(v1.0) Represents an object of type dimensionValue in Dynamics 365 Business Central

Operations

Business Central Dimension Line API

(v1.0) Represents an object of type dimensionLine in Dynamics 365 Business Central

Operations

Business Central Payment Term API

(v1.0) Represents an object of type paymentTerm in Dynamics 365 Business Central

Operations

Business Central Shipment Method API

(v1.0) Represents an object of type shipmentMethod in Dynamics 365 Business Central

Operations

Business Central Item Category API

(v1.0) Represents an object of type itemCategory in Dynamics 365 Business Central

Operations

Business Central Cash Flow Statement API

(v1.0) Represents an object of type cashFlowStatement in Dynamics 365 Business Central

Operations

Business Central Country Region API

(v1.0) Represents an object of type countryRegion in Dynamics 365 Business Central

Operations

Business Central Sales Order API

(v1.0) Represents an object of type salesOrder in Dynamics 365 Business Central

Operations

Business Central Sales Order Line API

(v1.0) Represents an object of type salesOrderLine in Dynamics 365 Business Central

Business Central Retained Earnings Statement API

(v1.0) Represents an object of type retainedEarningsStatement in Dynamics 365 Business Central

Operations

Business Central Unit Of Measure API

(v1.0) Represents an object of type unitOfMeasure in Dynamics 365 Business Central

Operations

Business Central Aged Accounts Receivable API

(v1.0) Represents an object of type agedAccountsReceivable in Dynamics 365 Business Central

Operations

Business Central Aged Accounts Payable API

(v1.0) Represents an object of type agedAccountsPayable in Dynamics 365 Business Central

Operations

Business Central Balance Sheet API

(v1.0) Represents an object of type balanceSheet in Dynamics 365 Business Central

Operations

Business Central Trial Balance API

(v1.0) Represents an object of type trialBalance in Dynamics 365 Business Central

Operations

Business Central Income Statement API

(v1.0) Represents an object of type incomeStatement in Dynamics 365 Business Central

Operations

Business Central Tax Area API

(v1.0) Represents an object of type taxArea in Dynamics 365 Business Central

Operations

Business Central Sales Quote API

(v1.0) Represents an object of type salesQuote in Dynamics 365 Business Central

Operations

Business Central Sales Quote Line API

(v1.0) Represents an object of type salesQuoteLine in Dynamics 365 Business Central

Business Central Sales Credit Memo API

(v1.0) Represents an object of type salesCreditMemo in Dynamics 365 Business Central

Operations

Business Central Sales Credit Memo Line API

(v1.0) Represents an object of type salesCreditMemoLine in Dynamics 365 Business Central

Business Central General Ledger Entry Attachments API

(v1.0) Represents an object of type generalLedgerEntryAttachments in Dynamics 365 Business Central

Operations

Business Central Purchase Invoice API

(v1.0) Represents an object of type purchaseInvoice in Dynamics 365 Business Central

Operations

Business Central Purchase Invoice Line API

(v1.0) Represents an object of type purchaseInvoiceLine in Dynamics 365 Business Central

Business Central Project API

(v1.0) Represents an object of type project in Dynamics 365 Business Central

Operations

Business Central Bank Account API

(v1.0) Represents an object of type bankAccount in Dynamics 365 Business Central

Operations

Business Central Customer Sale API

(v1.0) Represents an object of type customerSale in Dynamics 365 Business Central

Operations

Business Central Vendor Purchase API

(v1.0) Represents an object of type vendorPurchase in Dynamics 365 Business Central

Operations