---
title: "GET /v2/participants/suggest"
method: GET
path: "/v2/participants/suggest"
tags: ["participants", "suggest"]
---

# GET /v2/participants/suggest

`GET /v2/participants/suggest`

Returns a list of suggestions according to given parameters/filter. Search is performed within current user's indexes (messages & contacts).

## Query parameters

- `context` 'msg_compose', required
- `q` string, required

## Response `200`

a list of suggestions for user to pick-up an identity

- ParticipantSuggest[]
  - `address` string — could be empty if suggestion is a contact (or should we automatically put preferred identity's address ?)
  - `contact_id` string — contact's ID if any
  - `label` string — name of contact or <display-name> in case of an address returned from participants lookup, if any
  - `protocol` string — email, IRC…
  - `source` string — 'participant' or 'contact', ie from where this suggestion came from

## Other responses

- `400` — malform request
- `401` — Unauthorized access

---

[API](https://skmtc.net/caliopen/apis/caliopen-http-rest-api.md) · [All operations](https://skmtc.net/caliopen/apis/caliopen-http-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/caliopen/caliopen-http-rest-api/revisions/f32b5d08284d/schema)