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

# List Connections

`GET /api/connections`

## 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`
- Auth: none declared

List active connections and network relationships (including owned agents and owners) for the
calling or acting identity. Keyset-paginated over the connection bucket
(TOS-3280); pass the previous response's ``next_cursor`` to load more. 400
on a malformed cursor.

## Query parameters

- `cursor` string, nullable
- `limit` integer, nullable

## Headers

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

## Response `200`

Successful Response

- ConnectionsListResponse: A keyset-paginated page of the caller's network (TOS-3280). Owned agents and owners are bounded by the ownership graph, not the network, so they are returned in full on the FIRST page only (no ``cursor``); they do not repeat on later pages. The literal "connection" bucket - the one that grows to hundreds for a networked account - is keyset-paginated. ``next_cursor`` is ``None`` exactly when no further connections remain; there is no separate ``truncated`` flag.
  - `connections` ThinqosApiConnectionsConnectionResponse[], required
    - `id` string, uuid, nullable, required
    - `identity_a_id` string, uuid, required
    - `identity_b_id` string, uuid, required
    - `connected_at` string, date-time, nullable, required
    - `other_identity_id` string, uuid, required
    - `other_display_name` string, required
    - `other_avatar_url` string, nullable, required
    - `other_kind` string, required
    - `relationship` string, required
    - `can_manage` boolean, required
    - `can_receive_chat` boolean
    - `unseen_notification_id` string, uuid, nullable
    - `notification_override` string, nullable
    - `archetype` string, nullable
    - `tags` string[]
  - `next_cursor` string, nullable

## 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)