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

# List Connections

`GET /connections`

List all connections sorted by created_at in descending order. Results are paginated with a max limit of 100. When more documents are available, a `cursor` will be provided. Use the `cursor` parameter to retrieve the subsequent page.

## Query parameters

- `cursor` string, nullable — An opaque cursor for pagination
- `page_size` integer — The number of items per page (must be greater than 0 and less than or equal to 100)
- `filter` string, nullable — The metadata search filter. Returns only items which match the filter. The following filter operators are supported: $eq - Equal to (number, string, boolean), $ne - Not equal to (number, string, boolean), $gt - Greater than (number), $gte - Greater than or equal to (number), $lt - Less than (number), $lte - Less than or equal to (number), $in - In array (string or number), $nin - Not in array (string or number). The operators can be combined with AND and OR. Read [Metadata & Filters guide](https://docs.ragie.ai/docs/metadata-filters) for more details and examples.

## Headers

- `partition` string, nullable — An optional partition to scope the request to. If omitted, the request will be scoped to the default partition.

## Response `200`

Successful Response

- ConnectionList
  - `pagination` Pagination, required
    - `next_cursor` string, nullable
    - `total_count` integer, required
  - `connections` Connection[], required
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `metadata` object, required
    - `type` string, required
    - `name` string, required
    - `source` union, required
      - string
      - string[]
      - object
    - `enabled` boolean, required
    - `disabled_by_system_reason` 'connection_over_total_page_limit' | 'authentication_failed' | 'tenant_account_disabled', nullable, required
    - `last_synced_at` string, date-time, nullable
    - `syncing` boolean, nullable
    - `partition` string, nullable
    - `page_limit` integer, nullable, required
    - `sync_filter` SyncFilter, required
    - `disabled_by_system` boolean, required

## Other responses

- `401` — Unauthorized
- `402` — Payment Required
- `422` — Validation Error
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/ragie/apis/ragie-api.md) · [All operations](https://skmtc.dev/ragie/apis/ragie-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ragie/ragie-api/revisions/ffdf960539ca/schema)