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

# List all Connections

`GET /connect/connections`

## Request

- Base URL: `https://api.withpersona.com/api/v1`
- URL: `https://api.withpersona.com/api/v1/connect/connections`
- Auth: HTTP bearer

Returns a list of connect connections associated with your organization, including both outbound connections your organization created and inbound connections where your organization is the destination. Results are returned in reverse chronological order, with the most recently created objects first.

## Query parameters

- `page` ConnectConnectionsGetParametersPage
  - `after` string: Object ID for pagination cursor
  - `before` string: Object ID for pagination cursor
  - `size` number, double: Limit on the number of objects returned
- `fields` object
- `filter` ConnectConnectionsGetParametersFilter
  - `status` string: Filter connections by status
  - `destination-organization-id` string: Filter connections by destination organization ID — the organization authorized to access data through the connection.

## Headers

- `Key-Inflection` 'camel' | 'kebab' | 'snake'
- `Idempotency-Key` string
- `Persona-Version` '2026-09-29' | '2025-12-08' | '2025-10-27' | '2023-01-05' | '2022-09-01' | '2021-08-18' | '2021-07-05' | '2021-02-21' | '2020-05-18': Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).

## Response `200`

This endpoint returns a collection of Connections.

- ConnectListAllConnectConnectionsResponse200
  - `data` ConnectConnection[], required: An array of Connections
    - `type` 'connect/connection'
    - `id` string
    - `attributes` ConnectConnectionAttributes
      - `status` string: The current status of the connection. One of `pending`, `active`, `inactive`, or `archived`. An `archived` connection is never listed or retrievable directly; it only appears as the connection of an existing share token.
      - `destination-organization-id` string: The organization authorized to access objects through this connection.
      - `source-organization-id` string: The organization that created and owns this connection.
      - `created-at` string, date-time: The date and time when this connection was created
      - `updated-at` string, date-time: The date and time when this connection was last updated
    - `relationships` ConnectConnectionRelationships
      - `creator` ConnectConnectionRelationshipsCreator
        - `data` ConnectConnectionRelationshipsCreatorData, required
          - `id` string, required
          - `type` string, required: The type of the creator entity
  - `links` ConnectConnectionsGetResponsesContentApplicationJsonSchemaLinks, required
    - `prev` string, nullable, required: URL pointing to the previous page of data, or null if on the first page.
    - `next` string, nullable, required: URL pointing to the next page of data, or null if on the last page.

## Other responses

- `400`: The request was unacceptable, often due to invalid parameters.
- `401`: An invalid API key was provided.
- `403`: The given API key doesn’t have permissions to perform the request or a quota has been exceeded.
- `404`: The requested resource doesn’t exist.
- `429`: Your organization’s rate limit has been exceeded. We recommend an exponential backoff on requests.

---

[API](https://skmtc.dev/withpersona/apis/withpersona-3.md) - [All operations](https://skmtc.dev/withpersona/apis/withpersona-3/llms.txt) - [OpenAPI document](https://skmtc.dev/withpersona/apis/withpersona-3/revisions/0a3310d5046f?raw)