---
title: "Returns recent jobs for a connection. Jobs are returned in descending order by createdAt."
method: POST
path: "/v1/jobs/list"
tags: ["jobs"]
---

# Returns recent jobs for a connection. Jobs are returned in descending order by createdAt.

`POST /v1/jobs/list`

## Request body

- JobListRequestBody
  - `configId` string, required
  - `configTypes` JobConfigType[], required
  - `includingJobId` integer
  - `pagination` Pagination
    - `pageSize` integer
    - `rowOffset` integer

## Response `200`

Successful operation

- JobReadList
  - `jobs` JobWithAttemptsRead[], required
    - `attempts` AttemptRead[]
      - `bytesSynced` integer
      - `createdAt` integer, required
      - `endedAt` integer
      - `failureSummary` AttemptFailureSummary
        - `failures` AttemptFailureReason[], required
          - `externalMessage` string
          - `failureOrigin` 'source' | 'destination' | 'replication' | 'persistence' | 'normalization' | 'dbt' | 'airbyte_platform' | 'unknown' — Indicates where the error originated. If not set, the origin of error is not well known.
          - `failureType` 'config_error' | 'system_error' | 'manual_cancellation' | 'refresh_schema' — Categorizes well known errors into types for programmatic handling. If not set, the type of error is not well known.
          - `internalMessage` string
          - `retryable` boolean — True if it is known that retrying may succeed, e.g. for a transient failure. False if it is known that a retry will not succeed, e.g. for a configuration issue. If not set, retryable status is not well known.
          - `stacktrace` string
          - `timestamp` integer, required
        - `partialSuccess` boolean — True if the number of committed records for this attempt was greater than 0. False if 0 records were committed. If not set, the number of committed records is unknown.
      - `id` integer, required
      - `recordsSynced` integer
      - `status` 'running' | 'failed' | 'succeeded', required
      - `streamStats` AttemptStreamStats[]
        - `stats` AttemptStats, required
          - `bytesEmitted` integer
          - `estimatedBytes` integer
          - `estimatedRecords` integer
          - `recordsCommitted` integer
          - `recordsEmitted` integer
          - `stateMessagesEmitted` integer
        - `streamName` string, required
        - `streamNamespace` string
      - `totalStats` AttemptStats
        - `bytesEmitted` integer
        - `estimatedBytes` integer
        - `estimatedRecords` integer
        - `recordsCommitted` integer
        - `recordsEmitted` integer
        - `stateMessagesEmitted` integer
      - `updatedAt` integer, required
    - `job` JobRead
      - `configId` string, required
      - `configType` 'check_connection_source' | 'check_connection_destination' | 'discover_schema' | 'get_spec' | 'sync' | 'reset_connection', required
      - `createdAt` integer, required
      - `id` integer, required
      - `resetConfig` ResetConfig — contains information about how a reset was configured. only populated if the job was a reset.
        - `streamsToReset` StreamDescriptor[]
          - `name` string, required
          - `namespace` string
      - `startedAt` integer
      - `status` 'pending' | 'running' | 'incomplete' | 'failed' | 'succeeded' | 'cancelled', required
      - `updatedAt` integer, required
  - `totalJobCount` integer, required — the total count of jobs for the specified connection

## Other responses

- `404` — Object with given id was not found.
- `422` — Input failed validation

---

[API](https://skmtc.net/airbyte/apis/config.md) · [All operations](https://skmtc.net/airbyte/apis/config/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/airbyte/config/versions/ce48e08e02ec/schema)