web
You’re offline. This is a read only version of the page.
close
Skip to main content

Announcements

No record found.

News and Announcements icon
Community site session details

Community site session details

Session Id :
Small and medium business | Business Central, N...
Answered

Documented navigation properties are not available

(3) ShareShare
ReportReport
Posted on by 18
Hi there,
 
 
 
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
 
I have the same question (0)
  • maxklein Profile Picture
    12 on at
    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.
  • maxklein Profile Picture
    12 on at
    Please use api 2.0 for unitOfMeasure
  • Verified answer
    Matteo Fiocco Profile Picture
    260 on at

    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.

Under review

Thank you for your reply! To ensure a great experience for everyone, your content is awaiting approval by our Community Managers. Please check back later.

Helpful resources

Quick Links

Introducing the 2026 Season 1 community Super Users

Congratulations to our 2026 Super Stars!

Meet the Microsoft Dynamics 365 Contact Center Champions

We are thrilled to have these Champions in our Community!

Congratulations to the April Top 10 Community Leaders

These are the community rock stars!

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

#1
OussamaSabbouh Profile Picture

OussamaSabbouh 1,957 Super User 2026 Season 1

#2
YUN ZHU Profile Picture

YUN ZHU 956 Super User 2026 Season 1

#3
Teagen Boll Profile Picture

Teagen Boll 645 Super User 2026 Season 1

Last 30 days Overall leaderboard

Featured topics

Product updates

Dynamics 365 release plans