# Connections API

> List and fetch warehouse connections under /api/connections. Secrets are never returned.

*[View this page in the Flax docs](https://flax-analytics.com/docs/api-reference/connections)*

The connections endpoints expose the warehouse connections configured for your
organization. They require the `read` scope. Credentials are never returned by the
API — only connection metadata.

## List connections

`GET /api/connections` — return the connections the service account can read.

```bash
curl https://flax-analytics.com/api/connections \
  -H "Authorization: Bearer flax_pat_..."
```

Each connection includes its `driver` (`postgres`, `snowflake`, `databricks`, or
`bigquery`) and display name.

## Get a connection

`GET /api/connections/{connectionId}` — fetch a single connection by id. Returns
`404` if it does not exist or is not visible to the account.

## Related

- [Connecting data](/docs/connections/overview)
- [Connection security](/docs/connections/security)