---
title: "List the tenant's database connections"
method: GET
path: "/v1/connections"
tags: ["connections"]
---

# List the tenant's database connections

`GET /v1/connections`

## Request

- Base URL: `https://data.thinair.co`
- URL: `https://data.thinair.co/v1/connections`
- Auth: API key in header `x-api-key`

Returns name, id, dialect, and created-at for every connection registered to the calling tenant. Use the `name` field as the path parameter for `/v1/connections/:id/health` and `/v1/connections/:id/schema`. **Free to call** — never debits quota.

## Response `200`

Connection inventory.

- ConnectionsListResponse: Inventory of the tenant's registered database connections. Rows include name, id, dialect, and created-at. Connection strings and encrypted material are never returned. Free to call (`X-Quota-Cost: 0`).
  - `connections` ConnectionRow[], required
    - `name` string, required: Display name. Use this with `/v1/connections/:id/...` (the path id is the connection name).
    - `id` string, required: Stable internal id. Useful for disambiguating duplicate-name connections; otherwise prefer `name`.
    - `dbType` 'postgres' | 'mysql' | 'mssql', required: Dialect. Drives SQL syntax choice in subsequent calls.
    - `createdAt` string, required: ISO 8601 timestamp the connection was registered.
  - `rowCount` integer, required
  - `warnings` ConnectionDuplicateWarning[]
    - `code` 'DUPLICATE_NAME', required
    - `name` string, required
    - `count` integer, required
    - `message` string, required

## Other responses

- `401`: Authentication required or the session has no tenant binding.

---

[API](https://skmtc.dev/thinair/apis/thinair-data-api.md) · [All operations](https://skmtc.dev/thinair/apis/thinair-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thinair/apis/thinair-data-api/revisions/8a2a2d1b2400?raw)