---
title: "List connectors"
method: GET
path: "/api/connectors"
---

# List connectors

`GET /api/connectors`

## Request

- Base URL: `https://reduck.ai`
- URL: `https://reduck.ai/api/connectors`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

List your connectors for one profile (your own account when `profile` is omitted), by website. Summaries only: cookies are never part of a listing.

## Query parameters

- `profile` string: The end-user this connector is kept for, in your own naming (for example your user id). Omit, or leave empty, for your own account's connectors. Only an API key or an OAuth token can read or create an end-user's connector.

## Response `200`

OK

- Connector[]
  - `id` string, required
  - `host` string, required: The website, bare: no scheme, no leading "www.", e.g. "linkedin.com". For an SSO connector this is the identity provider, e.g. "accounts.google.com".
  - `profile_id` string, required: The end-user this connector is kept for, as the developer named them. Empty for the account's own connectors.
  - `account` string, nullable, required: The identity a probe script or the SSO sign-in reported (usually an email). Null until one has; it is never set by hand.
  - `label` string, nullable, required: The name a person gave this connector, to tell it apart from the host's others.
  - `is_sso` boolean, required: True when this is an identity-provider session usable for "Continue with <provider>".
  - `sso_account` string, nullable, required: For a connector created through an SSO connector: that SSO's account (email). The reference autoreconnect follows. Null otherwise.
  - `created_at` string, required
  - `updated_at` string, required

## Other responses

- `401`: Not authenticated
- `403`: Forbidden

---

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