---
type: api
title: Get all connectors
description: Get information about all connectors.
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v9/operation/operation-connector-list
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v9/operation/operation-connector-list
products:
  - Elasticsearch
---

# Get all connectors

Availability: 8.12+

## Paths

- `GET` `/_connector`

- [Api key auth](/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v9/authentication#apikeyauth)
- [Basic auth](/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v9/authentication#basicauth)
- [Bearer auth](/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v9/authentication#bearerauth)

## Description

Get information about all connectors.

## Query String Parameters

- `from` (number · default: 0)
  Starting offset
- `size` (number · default: 100)
  Specifies a max number of results to get
- `index_name` (union Indices)
  A comma-separated list of connector index names to fetch connector documents for
  One of: `IndexName` or `IndexName[]`
- `connector_name` (union Names)
  A comma-separated list of connector names to fetch connector documents for
  One of: `Name` or `Name[]`
- `service_type` (union Names)
  A comma-separated list of connector service types to fetch connector documents for
  One of: `Name` or `Name[]`
- `include_deleted` (boolean · default: false)
  A flag to indicate if the desired connector should be fetched, even if it was soft-deleted.
- `query` (string)
  A wildcard query string that filters connectors with matching name, description or index name

## Response

`application/json`

- `count` (number)
- `results` ([] Connector)
  - `api_key_id` (string)
  - `api_key_secret_id` (string)
  - `configuration` (ConnectorConfiguration)
  - `custom_scheduling` (ConnectorCustomScheduling)
  - `deleted` (boolean)
  - `description` (string)
  - `error` (union string) — nullable
    One of: `string`
  - `features` ({} ConnectorFeatures)
    - `document_level_security` ({} FeatureEnabled)
      Indicates whether document-level security is enabled.
      - `enabled` (boolean)
    - `incremental_sync` ({} FeatureEnabled)
      Indicates whether incremental syncs are enabled.
      - `enabled` (boolean)
    - `native_connector_api_keys` ({} FeatureEnabled)
      Indicates whether managed connector API keys are enabled.
      - `enabled` (boolean)
    - `sync_rules` ({} SyncRulesFeature)
      - `advanced` ({} FeatureEnabled)
        Indicates whether advanced sync rules are enabled.
        - `enabled` (boolean)
      - `basic` ({} FeatureEnabled)
        Indicates whether basic sync rules are enabled.
        - `enabled` (boolean)
  - `filtering` ([] FilteringConfig)
    - `active` ({} FilteringRules)
      - `advanced_snippet` ({} FilteringAdvancedSnippet)
        - `created_at` (DateTime)
        - `updated_at` (DateTime)
        - `value` (object)
      - `rules` ([] FilteringRule)
        - `created_at` (DateTime)
        - `field` (string Field)
        - `id` (string Id)
        - `order` (number)
        - `policy` (enum FilteringPolicy)
          Values: `exclude`, `include`
        - `rule` (enum FilteringRuleRule)
          Values: `contains`, `ends_with`, `equals`, `regex`, `starts_with`, `>`, `<`
        - `updated_at` (DateTime)
        - `value` (string)
      - `validation` ({} FilteringRulesValidation)
        - `errors` ([] FilteringValidation)
          - `ids` ([] string Id)
          - `messages` ([] string)
        - `state` (enum FilteringValidationState)
          Values: `edited`, `invalid`, `valid`
    - `domain` (string)
    - `draft` ({} FilteringRules)
      Same fields as `active` in `filtering`
  - `id` (string Id)
  - `index_name` (union IndexName | string) — nullable
  - `is_native` (boolean)
  - `language` (string)
  - `last_access_control_sync_error` (string)
  - `last_access_control_sync_scheduled_at` (DateTime)
  - `last_access_control_sync_status` (enum SyncStatus)
    Values: `canceling`, `canceled`, `completed`, `error`, `in_progress`, `pending`, `suspended`
  - `last_deleted_document_count` (number)
  - `last_incremental_sync_scheduled_at` (DateTime)
  - `last_indexed_document_count` (number)
  - `last_seen` (DateTime)
  - `last_sync_error` (string)
  - `last_sync_scheduled_at` (DateTime)
  - `last_sync_status` (enum SyncStatus)
    Values: `canceling`, `canceled`, `completed`, `error`, `in_progress`, `pending`, `suspended`
  - `last_synced` (DateTime)
  - `name` (string)
  - `pipeline` ({} IngestPipelineParams)
    - `extract_binary_content` (boolean)
    - `name` (string)
    - `reduce_whitespace` (boolean)
    - `run_ml_inference` (boolean)
  - `scheduling` ({} SchedulingConfiguration)
    - `access_control` ({} ConnectorScheduling)
      - `enabled` (boolean)
      - `interval` (string)
        The interval is expressed using the crontab syntax
    - `full` ({} ConnectorScheduling)
      - `enabled` (boolean)
      - `interval` (string)
        The interval is expressed using the crontab syntax
    - `incremental` ({} ConnectorScheduling)
      - `enabled` (boolean)
      - `interval` (string)
        The interval is expressed using the crontab syntax
  - `service_type` (string)
  - `status` (enum ConnectorStatus)
    Values: `created`, `needs_configuration`, `configured`, `connected`, `error`
  - `sync_cursor` (object)
  - `sync_now` (boolean)
## Code Examples

#### Console

```console
GET _connector
```

#### JavaScript

```javascript
const response = await client.connector.list();
```

#### Python

```python
resp = client.connector.list()
```

#### curl

```curl
curl -X GET "$ELASTICSEARCH_URL/_connector" \
  -H "Authorization: ApiKey $ELASTIC_API_KEY"
```

#### Java

```java
client.connector().list(l -> l);
```

#### PHP

```php
$resp = $client->connector()->list();
```

#### Ruby

```ruby
response = client.connector.list
```