Locationv2

List contact locations

GET/location/contacts

Returns cached FindMy contact locations available through your blooio account. Each entry includes the contact's handle (phone/email), coordinates, and last update time.

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

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

200List of contact locations

401Authentication required or invalid

404No active number is available for this API key

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

Request

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

Response objectexample

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