---
type: api
title: Get all connector sync jobs
description: Get information about all stored connector sync jobs listed by their creation date in ascending order.
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch-serverless/operation/operation-connector-sync-job-list
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch-serverless/operation/operation-connector-sync-job-list
products:
  - Elasticsearch Serverless
---

# Get all connector sync jobs

Availability:

## Paths

- `GET` `/_connector/_sync_job`

- [Api key auth](/elastic/docs-builder/docs/4371/api/doc/elasticsearch-serverless/authentication#apikeyauth)

## Description

Get information about all stored connector sync jobs listed by their creation date in ascending order.

## Query String Parameters

- `from` (number · default: 0)
  Starting offset
- `size` (number · default: 100)
  Specifies a max number of results to get
- `status` (enum SyncStatus)
  A sync job status to fetch connector sync jobs for
  Values: `canceling`, `canceled`, `completed`, `error`, `in_progress`, `pending`, `suspended`
- `connector_id` (string Id)
  A connector id to fetch connector sync jobs for
- `job_type` (union SyncJobType | [] SyncJobType)
  A comma-separated list of job types to fetch the sync jobs for

Supported values include: `full`, `incremental`, `access_control`
  Values: `full`, `incremental`, `access_control`

## Response

`application/json`

- `count` (number)
- `results` ([] ConnectorSyncJob)
  - `cancelation_requested_at` (DateTime)
  - `canceled_at` (DateTime)
  - `completed_at` (DateTime)
  - `connector` ({} SyncJobConnectorReference)
    - `configuration` (ConnectorConfiguration)
    - `filtering` ({} 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`
    - `id` (string Id)
    - `index_name` (string)
    - `language` (string)
    - `pipeline` ({} IngestPipelineParams)
      - `extract_binary_content` (boolean)
      - `name` (string)
      - `reduce_whitespace` (boolean)
      - `run_ml_inference` (boolean)
    - `service_type` (string)
    - `sync_cursor` (object)
  - `created_at` (DateTime)
  - `deleted_document_count` (number)
  - `error` (string)
  - `id` (string Id)
  - `indexed_document_count` (number)
  - `indexed_document_volume` (number)
  - `job_type` (enum SyncJobType)
    Values: `full`, `incremental`, `access_control`
  - `last_seen` (DateTime)
  - `metadata` (map string to object)
  - `started_at` (DateTime)
  - `status` (enum SyncStatus)
    Values: `canceling`, `canceled`, `completed`, `error`, `in_progress`, `pending`, `suspended`
  - `total_document_count` (number)
  - `trigger_method` (enum SyncJobTriggerMethod)
    Values: `on_demand`, `scheduled`
  - `worker_hostname` (string)
## Code Examples

#### Console

```console
GET _connector/_sync_job?connector_id=my-connector-id&size=1
```

#### JavaScript

```javascript
const response = await client.connector.syncJobList({
  connector_id: "my-connector-id",
  size: 1,
});
```

#### Python

```python
resp = client.connector.sync_job_list(
    connector_id="my-connector-id",
    size="1",
)
```

#### curl

```curl
curl -X GET "$ELASTICSEARCH_URL/_connector/_sync_job?connector_id=my-connector-id&size=1" \
  -H "Authorization: ApiKey $ELASTIC_API_KEY"
```

#### Java

```java
client.connector().syncJobList(s -> s
    .connectorId("my-connector-id")
    .size(1)
);
```

#### PHP

```php
$resp = $client->connector()->syncJobList([
    "connector_id" => "my-connector-id",
    "size" => "1",
]);
```

#### Ruby

```ruby
response = client.connector.sync_job_list(
  connector_id: "my-connector-id",
  size: "1"
)
```