Skip to main content
GET
List connected accounts with optional filters

Authorizations

x-api-key
string
header
default:your-project-api-key
required

Your Composio project API key. Create or copy it from the Composio dashboard.

Query Parameters

toolkit_slugs
string[] | null

The toolkit slugs of the connected accounts

statuses
enum<string>[] | null

The status of the connected account

Available options:
INITIALIZING,
INITIATED,
ACTIVE,
FAILED,
EXPIRED,
INACTIVE,
REVOKED
cursor
string | null

The cursor to paginate through the connected accounts

limit
number | null

The limit of the connected accounts to return

user_ids
string[] | null

The user ids of the connected accounts

auth_config_ids
string<authConfigId>[] | null

The auth config ids of the connected accounts

connected_account_ids
string<connectedAccountId>[] | null

The connected account ids to filter by

order_by
enum<string>
default:created_at

The order by of the connected accounts

Available options:
created_at,
updated_at
order_direction
enum<string>
default:desc

The order direction of the connected accounts

Available options:
asc,
desc
account_type
enum<string>

[Experimental] Filter by sharing model. Default (omitted) returns PRIVATE only — shared accounts must be requested explicitly. Pass SHARED for only shared accounts, or ALL for PRIVATE + SHARED.

Available options:
PRIVATE,
SHARED,
ALL

Response

Successfully retrieved connected accounts

items
object[]
required
total_pages
number
required
current_page
number
required
total_items
number
required
next_cursor
string | null