Bondery Docs
API reference_generatedcontacts/select

/contacts/select

GET
/contacts/select

List contacts for pickers and comboboxes (identity fields only, no channel enrichment).

Authorization

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"
keepInTouch?boolean
limit?integer
Range1 <= value <= 200
Default50
offset?integer
Range0 <= value <= 9007199254740991
Default0
search?string
sort?string

Value in

  • "nameAsc"
  • "nameDesc"
  • "surnameAsc"
  • "surnameDesc"
  • "interactionAsc"
  • "interactionDesc"
  • "createdAtAsc"
  • "createdAtDesc"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/contacts/select"
{  "contacts": [    {      "avatar": null,      "firstName": "Ada",      "id": "550e8400-e29b-41d4-a716-446655440000",      "lastName": "Lovelace",      "headline": "Mathematician",      "location": "London, UK",      "middleName": null,      "myself": false    }  ],  "pagination": {    "hasMore": false,    "limit": 50,    "offset": 0,    "search": null,    "sort": null,    "totalCount": 1  }}