---
title: "Connected-account counts by provider (COGS driver)"
method: GET
path: "/v1/admin/integrations/connected-accounts"
tags: ["admin"]
---

# Connected-account counts by provider (COGS driver)

`GET /v1/admin/integrations/connected-accounts`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/admin/integrations/connected-accounts`
- Auth: HTTP bearer

Active connected-account counts per provider. Pass ``tenant_id`` for one tenant's ``by_provider`` map, or omit it for the cross-tenant overview (``rows``). Read-only. Admin only.

## Query parameters

- `tenant_id` string, uuid, nullable: Scope to one tenant; omit for the platform overview.

## Response `200`

Successful Response

- ConnectedAccountCounts: Connected-account COGS view. Either one tenant's counts, or the platform-wide overview.
  - `tenant_id` string, nullable: Set when scoped to one tenant; null for the overview.
  - `by_provider` object: Provider → active account count (populated only for a single-tenant query).
  - `rows` ProviderCount[]: Cross-tenant (tenant, provider, count) rows for the overview.
    - `tenant_id` string, required: The tenant whose accounts are counted.
    - `provider` string, required: Integration provider (e.g. composio, slack).
    - `active_count` integer, required: ACTIVE, non-deleted connected accounts for this provider.
  - `total_active_accounts` integer, required: Sum of all active connected accounts in scope.

## Other responses

- `401`: Unauthorized
- `403`: Permission denied (PERMISSION_DENIED) or email not verified (EMAIL_NOT_VERIFIED)
- `422`: Validation error

---

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