> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.ovrsea.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Locations and visibility

> Read and share saved pickup and delivery locations

A location belongs to the account shown by `owner` in the response. The `visibility` field is either `private` or `public`.

Private locations are readable by their owning account and the accounts already authorized by its network. Public locations are shared with the owner's network. Public visibility shares the location with that network, not with one selected partner.

Use `GET /v1/locations` or `GET /v1/locations/{id}` to read the visibility and owner. A location that your token cannot read is returned as `404`, the same as an unknown location.

Use `POST /v1/locations` with `visibility` when creating an address. Use `PATCH /v1/locations/{id}/visibility` with `{ "visibility": "public" }` or `{ "visibility": "private" }` to change an existing address. The backend permissions for the owning account decide whether the change is allowed. A readable location that your token cannot modify returns `403` with the reason.

When an order is placed for another account, its pickup and delivery locations must be readable by that account. Sharing a location publicly makes it readable across the owner's network.


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