---
title: "Search connected accounts"
method: GET
path: "/api/v1/connected_accounts:search"
tags: ["Connected Accounts"]
---

# Search connected accounts

`GET /api/v1/connected_accounts:search`

Search for connected accounts in your environment using a text query that matches against identifiers, providers, or connectors. The search performs case-insensitive matching across account details. Returns paginated results with account status and authentication type information.

## Query parameters

- `query` string
- `page_size` integer
- `page_token` string
- `connection_id` string

## Response `200`

Successfully retrieved matching connected accounts with pagination support

- ConnectedAccountsSearchConnectedAccountsResponse
  - `connected_accounts` ConnectedAccountsConnectedAccountForList[] — List of connected accounts matching the search query. Excludes sensitive authorization details.
    - `authorization_type` 'OAUTH' | 'API_KEY' | 'BASIC_AUTH' | 'BEARER_TOKEN' | 'CUSTOM' | 'BASIC' | 'OAUTH_M2M' | 'TRELLO_OAUTH1' | 'GOOGLE_DWD' | 'TRUSTED_IDP' | 'SMART_FHIR' | 'NO_AUTH' — - OAUTH: OAuth 2.0 authorization with access and refresh tokens - API_KEY: Static API key authentication - BASIC_AUTH: HTTP Basic Authentication (username/password) - BEARER_TOKEN: Bearer token authentication - CUSTOM: Custom authentication mechanism - BASIC: Basic authentication (alias) - OAUTH_M2M: OAuth 2.0 client credentials (machine-to-machine) - TRELLO_OAUTH1: Trello token-based OAuth1-style browser authorization - GOOGLE_DWD: Google Domain-Wide Delegation - TRUSTED_IDP: Trusted Identity Provider federation (e.g. AWS STS AssumeRoleWithWebIdentity) - SMART_FHIR: SMART on FHIR (SMART App Launch) — OAuth 2.0 authorization for FHIR servers - NO_AUTH: No authentication — connector requires no credentials (e.g. public docs MCP servers)
    - `connection_id` string — Parent connection configuration reference.
    - `connector` string — Connector identifier.
    - `id` string — Unique connected account identifier.
    - `identifier` string — The unique identifier for this account in the third-party service.
    - `last_used_at` string, date-time — Last usage timestamp.
    - `provider` string — OAuth provider name (e.g., 'google', 'microsoft').
    - `status` 'ACTIVE' | 'EXPIRED' | 'PENDING_AUTH' | 'PENDING_VERIFICATION' | 'DISCONNECTED' — - ACTIVE: Account is connected and credentials are valid - EXPIRED: Access token has expired and needs refresh - PENDING_AUTH: Account awaiting user authorization (re-auth initiated) - PENDING_VERIFICATION: OAuth complete; awaiting user identity verification before activation - DISCONNECTED: Account has been manually disconnected
    - `token_expires_at` string, date-time — Token expiration timestamp.
    - `updated_at` string, date-time — Last modification timestamp.
  - `next_page_token` string — Pagination token for the next page. Empty if this is the last page.
  - `prev_page_token` string — Pagination token for the previous page. Empty if this is the first page.
  - `total_size` integer — Total count of accounts matching the search query across all pages.

## Other responses

- `400` — Invalid request - query parameter is too short (minimum 3 characters) or validation failed
- `401` — Authentication required - missing or invalid access token

---

[API](https://skmtc.net/scalekit/apis/scalekit-api-reference.md) · [All operations](https://skmtc.net/scalekit/apis/scalekit-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalekit/scalekit-api-reference/versions/a40d5d4650e5/schema)