---
title: "List connections a lookup column could read"
method: GET
path: "/table-integration-lookup/connections/"
tags: ["table-integration-lookup"]
---

# List connections a lookup column could read

`GET /table-integration-lookup/connections/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/table-integration-lookup/connections/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Every connected integration whose SDK can fetch single records, with the record types it can fetch: the Tools panel's 'Your data' section.

The connection and record-type list costs no network calls (capabilities are read off the SDK class), so a connection with expired credentials still appears, carrying its recorded health. Identity fields DO need the live connection; they are probed best-effort under a short per-connection budget and come back null where the probe failed. The identity-fields endpoint answers live for those.

## Response `200`

Successful Response

- LookupConnectionSchema[]
  - `health_status` string, nullable, required: The connection's last recorded health, or null when never checked.
  - `icon_url` string, nullable, required: The system's directory logo; null when the directory has none.
  - `integration_id` string, uuid, required
  - `integration_type` string, required: The system behind the connection, e.g. 'clerk'.
  - `name` string, required: The connection's own name, as its owner spelled it.
  - `record_types` LookupRecordTypeSchema[], required
    - `display_name` string, required: The record type's human name, e.g. 'User'.
    - `identity_fields` string[], nullable, required: The fields a lookup may key on ('id', 'email', ...), in the connection's own order. Null when the listing's best-effort probe could not learn them in budget. The record type is still lookupable, and the identity-fields endpoint answers live.
    - `slug` string, required: The record type's stable slug, e.g. 'user'.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/dc5ac3c84444?raw)