---
title: "List Suggestions"
method: GET
path: "/api/connections/suggestions"
tags: ["connections"]
---

# List Suggestions

`GET /api/connections/suggestions`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/connections/suggestions`
- Auth: none declared

People and agents you might want to connect with: an identity you share
an active chat with, or one connected to one of your own connections
(TOS-3442, TOS-3450). Accept by calling connection_request_send with the suggested
identity_id (or by POSTing to /api/connections/requests with it).

Not paginated: the underlying computation is a bounded, recompute-on-every-
call scan with no stable sort key to page over, not a stored ordered list.
Instead it is honest about completeness - see ``truncated`` on the
response.

## Headers

- `x-impersonate-identity-id` string, nullable

## Response `200`

Successful Response

- SuggestionsResponse: Connection suggestions, plus an honest completeness signal. Two signals feed ``suggestions`` (TOS-3442): ``reason == "shared_chat"`` (you share an active chat with them) and ``reason == "mutual_connection"`` (they're connected to one of your own connections, via ``via_identity_id``/``via_display_name``). This is a discovery aid over a bounded, on-the-fly computation, not a ranked top-N list - there is no score to report. ``truncated`` is True when the underlying computation hit one of its caps (a very active account: hundreds of chats or connections, or a very large room) and therefore MAY be missing a qualifying suggestion that a fuller scan would have found. ``False`` means the computation considered everything and this is the complete set.
  - `suggestions` SuggestedConnectionResponse[], required
    - `identity_id` string, uuid, required
    - `display_name` string, required
    - `kind` string, required
    - `reason` string, required
    - `via_identity_id` string, uuid, nullable, required
    - `via_display_name` string, nullable, required
    - `shared_chat_id` string, uuid, nullable, required
    - `shared_chat_title` string, nullable, required
  - `truncated` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thinqos/apis/thinqos-api.md) · [All operations](https://skmtc.dev/thinqos/apis/thinqos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thinqos/apis/thinqos-api/revisions/5387b4ded614?raw)