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

# List Connectors

> List connectors in your network with opportunity counts

List connectors (people) in your network. Connectors are the people you've imported whose LinkedIn connections are analyzed for referral opportunities.

## Query Parameters

<ParamField query="search" type="string">
  Search by connector name (partial match)
</ParamField>

<ParamField query="connector_tag" type="string">
  Filter by connector tag (e.g. `Employee`, `Friend`)
</ParamField>

<ParamField query="owner_email" type="string">
  Filter by owner: an email address (the same one you send as `owner_email` when
  importing) or an owner id from [List Owners](/api-reference/list-owners). Repeat
  the parameter or comma-separate several values. Pass `unassigned` for connectors
  nobody owns. A value that matches no owner returns an empty page.

  This mirrors the `owners` filter on
  [Search Opportunities](/api-reference/search-opportunities), which already
  accepts the same values.
</ParamField>

<ParamField query="page" type="integer" default="1" />

<ParamField query="page_size" type="integer" default="25" />

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.clustr-ai.com/api/public/network/connectors?connector_tag=Employee" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "connectors": [
        {
          "name": "Nicolas Delaye",
          "linkedin_id": "nicdelaye",
          "linkedin_url": "https://www.linkedin.com/in/nicdelaye",
          "job_title": "Global Accounting Vertical Lead",
          "company_name": "Laurel",
          "connector_tags": ["Employee"],
          "opportunities_count": 63,
          "owner_id": "8f1b2c34-5d6e-4f70-8a91-b2c3d4e5f607",
          "owner_email": "marine.b@example.com",
          "owner_name": "Marine B"
        }
      ],
      "total": 42,
      "page": 1,
      "page_size": 25,
      "has_more": true
    }
  }
  ```
</ResponseExample>

## Owners

`owner_id`, `owner_email` and `owner_name` are present only when a teammate owns
the connector. Connectors with no owner omit all three, and you can list exactly
those with `?owner_email=unassigned`.

Set it at import time with `owner_email` on
[Import Connectors](/api-reference/import-connectors), or at any time afterwards with
[Set Connector Owner](/api-reference/set-connector-owner).

To find teammates who have not contributed any connectors yet, call
[List Owners](/api-reference/list-owners) with `with_counts=true` and look for an
`opportunity_count` of `0`.