Locationv2

Refresh contact locations

POST/location/contacts/refresh

Triggers a refresh of cached FindMy contact locations. Updated results may take 15-20 seconds to appear.

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Returns

successoptionalboolean

friendsoptionalContactLocation[]

Array of ContactLocation

handleoptionalstring

Contact's phone number or email

coordinatesoptionalnumber[]

GPS coordinates [latitude, longitude]

statusoptionalstring

Location status (e.g., 'live', 'shallow', 'legacy')

last_updatedoptionalinteger

Timestamp of last location update (epoch ms)

Response codes

200Refresh triggered, returns updated locations

401Authentication required or invalid

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request

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

Response objectexample

{  "success": false,  "friends": [    {      "handle": "blooio",      "coordinates": [        0      ],      "status": "active",      "last_updated": 0    }  ]}