Microsoft Dynamics 365 Business Central API
/
Default built by Microsoft
/
Business Central Default Dimensions API
/
Creates an object of type defaultDimensions in 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
default-built-by-microsoft.json
default-built-by-microsoft.yaml
Languages
Servers
Mock server

https://docs.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/

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

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

Returns a list of defaultDimensions

Request

Path
company_idstring(uuid)required

(v1.0) id for company

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
vendor_idstring(uuid)required

(v1.0) id for vendor

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
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

$expandArray of strings

(v1.0) Entities to expand

Items Enum"account""dimension""dimensionValue"
$selectArray of strings

(v1.0) Selected properties to be retrieved

Items Enum"parentId""dimensionId""dimensionCode""dimensionValueId""dimensionValueCode""postingValidation"
curl -i -X GET \
  'https://docs.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/vendors(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/defaultDimensions?%24expand=account&%24filter=string&%24limit=100&%24select=parentId&%24skip=0&%24top=100' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

(v1.0) Succesfully returned a list of defaultDimensions

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

Creates an object of type defaultDimensions in Dynamics 365 Business Central

Request

Path
company_idstring(uuid)required

(v1.0) id for company

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
vendor_idstring(uuid)required

(v1.0) id for vendor

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
Headers
Content-Typestringrequired

(v1.0) application/json

Bodyapplication/jsonrequired
parentIdstring or null(uuid)

(v1.0) The parentId property for the Dynamics 365 Business Central defaultDimensions entity

Example: "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4"
dimensionIdstring or null(uuid)

(v1.0) The dimensionId property for the Dynamics 365 Business Central defaultDimensions entity

Example: "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4"
dimensioncodestring or null<= 20 characters

(v1.0) The dimensionCode property for the Dynamics 365 Business Central defaultDimensions entity

Example: null
dimensionValueIdstring or null(uuid)

(v1.0) The dimensionValueId property for the Dynamics 365 Business Central defaultDimensions entity

Example: null
dimensionValuecodestring or null<= 20 characters

(v1.0) The dimensionValueCode property for the Dynamics 365 Business Central defaultDimensions entity

Example: null
postingValidationstring or null

(v1.0) The postingValidation property for the Dynamics 365 Business Central defaultDimensions entity

Example: null
curl -i -X POST \
  'https://docs.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/vendors(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/defaultDimensions' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "parentId": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "dimensionId": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "dimensioncode": null,
    "dimensionValueId": null,
    "dimensionValuecode": null,
    "postingValidation": null
  }'

Responses

(v1.0) A new defaultDimensions has been succesfully created

Bodyapplication/json
parentIdstring(uuid)

(v1.0) The parentId property for the Dynamics 365 Business Central defaultDimensions entity

Example: "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4"
dimensionIdstring(uuid)

(v1.0) The dimensionId property for the Dynamics 365 Business Central defaultDimensions entity

Example: "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4"
dimensionCodestring or null<= 20 characters

(v1.0) The dimensionCode property for the Dynamics 365 Business Central defaultDimensions entity

Example: null
dimensionValueIdstring or null(uuid)

(v1.0) The dimensionValueId property for the Dynamics 365 Business Central defaultDimensions entity

Example: null
dimensionValueCodestring or null<= 20 characters

(v1.0) The dimensionValueCode property for the Dynamics 365 Business Central defaultDimensions entity

Example: null
postingValidationstring or null

(v1.0) The postingValidation property for the Dynamics 365 Business Central defaultDimensions entity

Example: null
accountobject(account)
dimensionobject(dimension)
dimensionValueobject(dimensionValue)
Response
application/json
{
  "parentId": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
  "dimensionId": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
  "dimensionCode": null,
  "dimensionValueId": null,
  "dimensionValueCode": null,
  "postingValidation": null,
  "account": {
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "number": null,
    "displayName": null,
    "category": null,
    "subCategory": null,
    "blocked": null,
    "lastModifiedDateTime": null
  },
  "dimension": {
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "code": null,
    "displayName": null,
    "lastModifiedDateTime": null,
    "dimensionValues": [ … ]
  },
  "dimensionValue": {
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "code": null,
    "displayName": null,
    "lastModifiedDateTime": null
  }
}

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

Request

Path
company_idstring(uuid)required

(v1.0) id for company

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
vendor_idstring(uuid)required

(v1.0) id for vendor

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
defaultDimensions_parentIdstring(uuid)required

(v1.0) parentId for defaultDimensions

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
defaultDimensions_dimensionIdstring(uuid)required

(v1.0) dimensionId for defaultDimensions

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
Query
$expandArray of strings

(v1.0) Entities to expand

Items Enum"account""dimension""dimensionValue"
$selectArray of strings

(v1.0) Selected properties to be retrieved

Items Enum"parentId""dimensionId""dimensionCode""dimensionValueId""dimensionValueCode""postingValidation"
curl -i -X GET \
  'https://docs.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/vendors(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/defaultDimensions(e942a270-62d2-4aef-aa48-6fe3ef9e53e1,e942a270-62d2-4aef-aa48-6fe3ef9e53e1)?%24expand=account&%24select=parentId' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

(v1.0) Succesfully returned the requested defaultDimensions

Bodyapplication/json
parentIdstring(uuid)

(v1.0) The parentId property for the Dynamics 365 Business Central defaultDimensions entity

Example: "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4"
dimensionIdstring(uuid)

(v1.0) The dimensionId property for the Dynamics 365 Business Central defaultDimensions entity

Example: "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4"
dimensionCodestring or null<= 20 characters

(v1.0) The dimensionCode property for the Dynamics 365 Business Central defaultDimensions entity

Example: null
dimensionValueIdstring or null(uuid)

(v1.0) The dimensionValueId property for the Dynamics 365 Business Central defaultDimensions entity

Example: null
dimensionValueCodestring or null<= 20 characters

(v1.0) The dimensionValueCode property for the Dynamics 365 Business Central defaultDimensions entity

Example: null
postingValidationstring or null

(v1.0) The postingValidation property for the Dynamics 365 Business Central defaultDimensions entity

Example: null
accountobject(account)
dimensionobject(dimension)
dimensionValueobject(dimensionValue)
Response
application/json
{
  "parentId": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
  "dimensionId": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
  "dimensionCode": null,
  "dimensionValueId": null,
  "dimensionValueCode": null,
  "postingValidation": null,
  "account": {
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "number": null,
    "displayName": null,
    "category": null,
    "subCategory": null,
    "blocked": null,
    "lastModifiedDateTime": null
  },
  "dimension": {
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "code": null,
    "displayName": null,
    "lastModifiedDateTime": null,
    "dimensionValues": [ … ]
  },
  "dimensionValue": {
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "code": null,
    "displayName": null,
    "lastModifiedDateTime": null
  }
}

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