---
title: "List Instances"
method: GET
path: "/api/integrations/instances"
tags: ["integrations"]
---

# List Instances

`GET /api/integrations/instances`

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

Paginated list of instances the caller owns or is a folder member of (P3).

TOS-831: when ``library_id`` is supplied, narrows to instances in that one
folder (the Library page's Integrations tab); otherwise returns the union
across every folder the caller can touch (the "My Integrations" view).

TOS-2705: ``q`` searches instance alias / definition name / description and
``ids`` narrows to an explicit instance set, both SERVER-side. The identity
Integrations surface previously fetched one 200-row page and searched it in
the browser, so integration 201 onward could not be found at all. Search and
paging now run against the true total, and the Connected list requests its
subject's live ids directly rather than relying on them being inside page 1.

TOS-3006 Defect D: ``subject_identity_id`` is the profile being configured.
When supplied, rows are additionally limited to source folders that subject
reaches, exactly matching the attach gate. This prevents Discover from
advertising an install that would be refused; it never grants membership.

TOS-4113 Lane A: ``org_tenant_id`` narrows to the shared folders of one
organization, which is what the organization page's Connected accounts
section asks for. ``library_id`` cannot express that: an organization has
many root folders and many subfolders under them. Like every other
parameter here it only ever NARROWS the caller's own visible set, so it is
not a way to read an organization the caller is not in.

## Query parameters

- `page` integer
- `size` integer
- `library_id` string, uuid, nullable
- `include_icon_data` boolean
- `q` string, nullable
- `ids` string[], nullable
- `definition_id` string, uuid, nullable
- `owned_by_viewer` boolean
- `subject_identity_id` string, uuid, nullable
- `org_tenant_id` string, uuid, nullable

## Headers

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

## Response `200`

Successful Response

- object

## 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/5fdd1072e877?raw)