Graph API Taxonomy $expand=children Not Working

Roberto Notario McDonnell 0

Summary

The $expand=children query parameter does not return children properties for taxonomy terms, even when terms have verified hierarchical relationships.

Environment

API: Microsoft Graph v1.0
Endpoint: /sites/{site-id}/termStore/sets/{termset-id}/terms
Date: June 19, 2025

Expected Behavior

When using $expand=children, terms with child terms should include a children array property.

Actual Behavior

Terms are returned without any children property, even when children exist (verified via SharePoint Admin Center and direct children endpoints).

Reproduction Steps

Create a term set with hierarchical terms in SharePoint Admin Center
Query: GET /sites/{site-id}/termStore/sets/{termset-id}/terms?$expand=children
Observe that no children properties are returned

Working Alternatives

Direct children endpoint works: /terms/{term-id}/children

Share via