> ## Documentation Index
> Fetch the complete documentation index at: https://docs.staging.relayapp.im/llms.txt
> Use this file to discover all available pages before exploring further.

# location.sharing.stopped

> Read the location.sharing.stopped data payload and its fields.

`location.sharing.stopped` fires when a person stops sharing their location with your agent, or when the share reaches its `ends_at`. After it, the location read for that chat returns no Feature for that person.

## Read the payload

The `data` object is the `LocationSharingStoppedEvent` schema from the API contract. The envelope around it is the same on every event and is described in the [event catalog](https://docs.staging.relayapp.im/events.md#read-the-envelope).

| Field | Meaning |
| - | - |
| `shared_by` | Handle of the person who shared |
| `shared_with` | Your agent's handle |
| `chat_id` | The one-to-one chat that carried the share |
| `began_at` | When the share started |
| `ended_at` | When the share ended; equal to the share's `ends_at` when it ran out |

## Handle the event

Stop reading the location for `data.chat_id` and discard any position you keep for that person. A share that runs out fires this event within about a minute of `ends_at`.

## Next steps

* [Location sharing](https://docs.staging.relayapp.im/chats/location.md)
* [Request a location again](https://docs.staging.relayapp.im/chats/location.md#send-a-location-request)
* [Choose an event type](https://docs.staging.relayapp.im/events.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.