API reference_generatedcontacts/map-pins
/contacts/map-pins
Fetch lightweight map pins for contacts within a bounding box.
AuthorizationBearer <token>
Better Auth session access token (OAuth 2.1) from the webapp or mobile app. Send as Authorization: Bearer <access_token>.
In: header
Query Parameters
avatarQuality?string
Value in
- "low"
- "medium"
- "high"
avatarSize?string
Value in
- "small"
- "medium"
- "large"
limit?integer
Range
1 <= value <= 1000Default
500maxLat*number
Range
-90 <= value <= 90maxLon*number
Range
-180 <= value <= 180minLat*number
Range
-90 <= value <= 90minLon*number
Range
-180 <= value <= 180Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/contacts/map-pins?maxLat=-90&maxLon=-180&minLat=-90&minLon=-180"{ "pins": [ { "avatar": null, "firstName": "Ada", "headline": "Mathematician", "id": "550e8400-e29b-41d4-a716-446655440000", "lastInteraction": "2026-01-15T12:00:00.000Z", "lastName": "Lovelace", "latitude": 51.5074, "location": "London, UK", "longitude": -0.1278 } ]}