GET /v1/conversations/:id/location

GET /v1/conversations/{conversationId}/location

The latest Find My observation for each participant in a DM. The same object the stream emits as event: location. conversationId is the handle's DM, never a group. Fix fields are numbers on /v1.

This is a synchronous read. After a drop, includeLocations: true on POST /v1/replay returns the same latest-per-participant set.

Request

curl https://api.mapier.ai/v1/conversations/a0000000-0000-4000-8000-000000000001/location \
  -H "Authorization: Bearer $MAPIER_API_KEY"

Response

Each observation matches the live location frame:

200

{
  "locations": [
    {
      "conversationId": "a0000000-0000-4000-8000-000000000001",
      "occurredAt": "2026-08-24T18:07:00.000Z",
      "from": "+14155550100",
      "event": "location_update",
      "latitude": 40.76203,
      "longitude": -73.985918
    }
  ]
}

Prop

Type

A maps-link pin in a bubble is still event: message with a maps URL in text. This route is Find My.

Errors

Status	Code	Cause
`401`	`unauthenticated`	No credential
`404`	`conversation_not_found`	Not yours, not a DM, or the id does not exist
`503`	`upstream_unavailable`	The Mac cannot read right now

Location events

The live SSE frame. Same object.

POST /v1/replay

includeLocations after a drop.