Small and medium business | Business Central, N...

Answered

Documented navigation properties are not available

(3) Share

Report

Posted on by CU07050406-0

Hi there,

I'm trying to query the Items API, going off the docs here: https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v2.0/resources/dynamics_item

Specifically, the navigation properties, here: https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v2.0/resources/dynamics_item#navigation

The documentation lists numerous properties that are not available.

For example, this HTTP request:

curl --request GET \
  --url 'https://api.businesscentral.dynamics.com/v2.0/<tenant-id>/Production/api/v1.0/companies(<company-id>)/items(<item-id>)?%24expand=itemCategory%2Cpicture%2CdefaultDimensions%2CitemVariants' \
  --header 'Authorization: Bearer <auth-token>'

Returns the item with all navigation properties filled (itemCategory, picture, defaultDimensions, itemVariants)

However, this HTTP request:

curl --request GET \
  --url 'https://api.businesscentral.dynamics.com/v2.0/<tenant-id>/Production/api/v1.0/companies(<company-id>)/items(<item-id>)?%24expand=unitOfMeasure%2CitemCategory%2Cpicture%2CdefaultDimensions%2CitemVariants' \
  --header 'Authorization: Bearer <auth-token>'

Returns:

{
	"error": {
		"code": "BadRequest",
		"message": "Could not find a property named 'unitOfMeasure' on type 'Microsoft.NAV.item'.  CorrelationId:  e5f99925-8842-4ccc-9295-13406d0e7cef."
	}
}

The linked documentation suggests that this property should be available.

Appreciating any insight with thanks,
Michael

Categories:

Dynamics 365 Business Central

I have the same question (0)

All responses (3)

Answers (1)

Sort by

maxklein 12 on at

Like (1)

Report
Copy link

Link copied!

Remove unitOfMeasure from the $expand list — it's not valid. Instead, either request baseUnitOfMeasure via $select, or build a custom API if deeper info is needed.

Was this reply helpful? Yes No
maxklein 12 on at

Like (1)

Report
Copy link

Link copied!

Please use api 2.0 for unitOfMeasure

Was this reply helpful? Yes No
Verified answer

Matteo Fiocco 260 on at

Like (1)

Report
Copy link

Link copied!

The issue isn’t with your request or token — the problem is that the unitOfMeasure navigation property is not actually exposed in the standard Business Central API, even though it's listed in the official documentation.

You can confirm this by checking the $metadata endpoint, which shows the actual structure and available properties of the API.

As a workaround, either use available fields like baseUnitOfMeasureCode, or create a custom API page in AL that includes unitOfMeasure as a navigation property if you need that relationship. Unfortunately, some navigation properties in the docs are planned or internal but not implemented in the public API.

Was this reply helpful? Yes No

Join the conversation

Community site session details

Documented navigation properties are not available

Helpful resources

News and Announcements

Quick Links

Season of Sharing Community Challenge Launch!

Women in Power Builds Momentum

Congratulations to the April Top 10 Community Leaders

Leaderboard > Small and medium business | Business Central, NAV, RMS

Featured topics

Product updates

Community site session details

Documented navigation properties are not available

Helpful resources

News and Announcements

Quick Links

Season of Sharing Community Challenge Launch!

Women in Power Builds Momentum

Congratulations to the April Top 10 Community Leaders

Subscribe to this forum!

Select categories

Leaderboard > Small and medium business | Business Central, NAV, RMS

Featured topics

Product updates