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

# List Source Connections

`GET /source-connections`

## Request

- Base URL: `https://api.airweave.ai`
- URL: `https://api.airweave.ai/source-connections`
- Auth: API key in header `x-api-key`

Retrieve all source connections for your organization.

Returns a lightweight list of source connections with essential fields for
display and navigation. Use the collection filter to see connections within
a specific collection.

For full connection details including sync history, use the GET /{id} endpoint.

## Query parameters

- `collection` string, nullable: Filter by collection readable ID
- `skip` integer: Number of connections to skip for pagination
- `limit` integer: Maximum number of connections to return (1-1000)

## Response `200`

List of source connections

- SourceConnectionListItem[]
  - `id` string, uuid, required: Unique identifier of the source connection
  - `name` string, required: Display name of the connection
  - `short_name` string, required: Source type identifier
  - `readable_collection_id` string, required: Collection this connection belongs to
  - `created_at` string, date-time, required: When the connection was created (ISO 8601)
  - `modified_at` string, date-time, required: When the connection was last modified (ISO 8601)
  - `is_authenticated` boolean, required: Whether the connection has valid credentials
  - `entity_count` integer: Total number of entities synced from this connection
  - `federated_search` boolean: Whether this source uses federated (real-time) search instead of syncing
  - `auth_method` 'direct' | 'oauth_browser' | 'oauth_token' | 'oauth_byoc' | 'auth_provider', required: Authentication methods for source connections.
  - `status` 'active' | 'pending_auth' | 'syncing' | 'error' | 'inactive' | 'pending_sync', required: Source connection status enum - represents overall connection state.

## Other responses

- `422`: Validation Error
- `429`: Rate Limit Exceeded

## Changes

> 63 revisions in range; 2 not diffed.

- **2026-02-04** `9c8b36d8fcaa`: 3 info
  - added the non-success response with the status `429`
  - the response property `detail` became required for the status `422`
  - response property `detail/items/loc/items/` list-of-types was narrowed by removing types `integer` from media type `application/json` of response `422`
- **2025-10-09** `c25c4670614e`: 1 info
  - added the optional property `items/federated_search` to the response with the `200` status
- **2025-09-25** `34d41e7f360f`: 5 warning
  - removed the optional property `items/connection_init_session_id` from the response with the `200` status
  - removed the optional property `items/is_active` from the response with the `200` status
  - removed the optional property `items/last_job_status` from the response with the `200` status
  - removed the optional property `items/last_sync` from the response with the `200` status
  - …1 more
- **2025-09-19** `097d993fdf58`: 2 breaking, 7 warning, 6 info
  - removed the required property `items/collection` from the response with the `200` status
  - removed the required property `items/sync_id` from the response with the `200` status
  - for the `query` request parameter `skip`, the min was set to `0.00`
  - removed the optional property `items/description` from the response with the `200` status
  - …11 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/airweave-ai/apis/airweave/changes/source-connections/get.md)

---

[API](https://skmtc.dev/airweave-ai/apis/airweave.md) - [All operations](https://skmtc.dev/airweave-ai/apis/airweave/llms.txt) - [OpenAPI document](https://skmtc.dev/airweave-ai/apis/airweave/revisions/bf410c28c0c6?raw)