> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bringin.app/llms.txt
> Use this file to discover all available pages before exploring further.

# List connections

List all connections for the authenticated user within your application. Only returns connections with status `INITIATING`, `PENDING`, or `ACTIVE`. Terminal statuses (`FAILED`, `EXPIRED`, `INACTIVE`) are excluded.

Requires a **per-user api-key**.

<Tip>Always call this endpoint before creating a new connection to avoid `409` duplicate errors.</Tip>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "bringinLink": {
        "id": "a8558b90-6a87-4c81-a767-9725d5a23a45",
        "name": "Cake wallet",
        "type": "FIAT_TO_CRYPTO",
        "subtype": "ONCHAIN",
        "status": "ACTIVE",
        "createdAt": "2026-03-24T08:31:53.143Z",
        "updatedAt": "2026-03-24T08:34:08.077Z"
      },
      "standingOrder": {
        "id": "a5b03095-f4ad-4a10-8970-4c63de5a49a9",
        "status": "ACTIVE",
        "direction": "FIAT_TO_CRYPTO",
        "sourceCurrency": "EUR",
        "destinationCurrency": "USDC",
        "percentFeeBps": "1",
        "createdAt": "2026-03-24T08:33:18.366Z",
        "updatedAt": "2026-03-24T08:34:08.070Z"
      },
      "depositIban": "MT77CFTE28004000000000005960390",
      "destinationAddress": "0x5919d3A265d85732dB16A1EE7eCe8795719fEED4"
    },
    {
      "bringinLink": {
        "id": "b78f5b8d-11f5-492e-9844-42dfdc3c9528",
        "name": "Wise",
        "type": "CRYPTO_TO_FIAT",
        "subtype": "LN",
        "status": "ACTIVE",
        "createdAt": "2026-03-09T10:53:27.106Z",
        "updatedAt": "2026-03-09T10:53:57.242Z"
      },
      "standingOrder": {
        "id": "e77d7fc8-7c3f-4f05-8020-916add8c1aa8",
        "status": "ACTIVE",
        "direction": "CRYPTO_TO_FIAT",
        "sourceCurrency": "BTC",
        "destinationCurrency": "EUR",
        "percentFeeBps": "0.01",
        "createdAt": "2026-03-09T10:53:34.156Z",
        "updatedAt": "2026-03-09T10:53:57.234Z"
      },
      "lnAddress": "alice_wise@bringin.xyz",
      "destinationIban": "BE65967689052596"
    }
  ]
  ```
</ResponseExample>

Results are sorted by `createdAt` descending (newest first). The `standingOrder` field is `null` for `INITIATING` connections that haven't reached standing order creation yet.

### Connection statuses

| Status       | Terminal? | Meaning                                                    |
| ------------ | --------- | ---------------------------------------------------------- |
| `INITIATING` | No        | Being created in the background                            |
| `PENDING`    | No        | Awaiting SMS OTP confirmation                              |
| `ACTIVE`     | No        | Confirmed — auto-conversions enabled                       |
| `FAILED`     | Yes       | Creation failed (not returned in list)                     |
| `EXPIRED`    | Yes       | OTP not confirmed within 30 minutes (not returned in list) |
| `INACTIVE`   | Yes       | Cancelled by user (not returned in list)                   |

### Use this endpoint to

* Check for existing connections before creating a new one
* Display the user's active connections
* Find `PENDING` connections that need OTP confirmation