Locationv2

Get contact location

GET/location/contacts/{handle}

Returns the cached location for a specific contact identified by phone number or email.

Path parameters

handleRequiredstring

Contact's phone number (E.164) or email address

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

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)

200Contact location data

400Invalid request parameters

401Authentication required or invalid

404No location found for this contact

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/blooio \  -H "Authorization: Bearer bl_live_..."

Response objectexample

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