How to retrieve whether an embedded app is pinned in the navigation

In an embedded app, merchants can pin the app by clicking the pin icon either at the bottom left of the navigation or at the top right of the app.

How can the app retrieve the pin status? Is there an API or any other method to achieve this?