Yes, this is on purpose as the response of
get_milestones can be very large for long-lived projects with many milestones + sub-milestones and the milestone API behaves in a similar way to
get_plan. It's planned to add additional options to the API in the future, e.g. to control the fields you want to include and also to include nested properties.