Docs
BetaThe V4 API is in beta — endpoints and functionality may change.

Location tracking

Read Find My friend locations shared with your linked Apple account.

The Location API exposes Find My person-sharing data available to the Apple account linked to your Blooio service. Contacts only appear if they already share location with that account in Find My.

List contacts

curl https://api.blooio.com/v4/location/contacts \
  -H "Authorization: Bearer bl_live_..."
Try it

Get one contact

curl https://api.blooio.com/v4/location/contacts/%2B15551234567 \
  -H "Authorization: Bearer bl_live_..."
Try it

Refresh

Force a device refresh (can take ~15–20s):

curl -X POST https://api.blooio.com/v4/location/contacts/refresh \
  -H "Authorization: Bearer bl_live_..."
Try it

Statuses such as live, shallow, and legacy describe how fresh the cached point is — poll after refresh if you need the newest coordinates.