Get dimensionLines
Retrieve the properties and relationships of a dimension line object for Dynamics 365 Business Central.
Prerequisites
HTTP request
Replace the URL prefix for Dynamics 365 Business Central depending on environment following the guideline.
If you want to receive all of the dimension lines of a specific parent entity, you can do it with the following URL:
GET businesscentralPrefix/companies({id})/dimensionLines?$filter=parentId eq ({id})
In order to get a specific dimension line, you can use the following URL:
GET businesscentralPrefix/companies({id})/dimensionLines(parentId=({id}),id=({id}))
Request headers
Header | Value |
---|---|
Authorization | Bearer {token}. Required. |
Request body
Do not supply a request body for this method.
Response
If successful, this method returns a 200 OK
response code and a dimensionLines object in the response body.
Example
Request
Here is an example of the request.
GET https://{businesscentralPrefix}/api/beta/companies({id})/dimensionLines(parentId=({id}),id=({id}))
Response
Here is an example of the response.
Note
The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
{
"parentId": "id-value",
"id": "id-value",
"code": "DEPARTMENT",
"displayName": "Department",
"valueId": "id-value",
"valueCode": "SALES",
"valueDisplayName": "Sales"
}
See also
Tips for working with the APIs
Working with Dynamics 365 Business Central in Microsoft Graph
Enabling the APIs for Dynamics 365 Business Central
Endpoints for the APIs
Error Codes
Dimension Line
Post Dimension Line
Patch Dimension Line
Delete Dimension Line