Get location data

Retrieve the current location for contacts sharing with you in a chat.

The response is wrapped in the standard { "success": true, "data": ... } envelope — the body is not a bare GeoJSON document. data is a GeoJSON FeatureCollection with a Feature for each participant actively sharing their location.

Works for both 1:1 and group chats. In group chats, data.features contains a separate feature for each participant who is sharing. Each feature's properties.handle identifies the user.

A participant appears as soon as their first position arrives, typically within a second or two of sharing starting.

Returns an empty data.features array if no one is sharing or no location data is available yet. If sharing started but this stays empty, see the Location Sharing overview.

Poll this endpoint to track a moving contact. properties.updated_at reflects when each participant's location was last updated. There is no coordinate-update webhook. See the Location Sharing overview for polling guidance.