---
title: "List All Automated Jobs"
method: GET
path: "/jobs/automated"
tags: ["Management"]
---

# List All Automated Jobs

`GET /jobs/automated`

Get all automated jobs. Automated jobs are completed by a machine. By default, jobs are sorted in descending order by submission time. For scheduled jobs such as data syncs, only the next scheduled job is shown.

## Query parameters

- `limit` integer
- `offset` integer

## Headers

- `Finch-API-Version` string, date, required

## Response `200`

Job was found

- object
  - `meta` object, required
    - `quotas` object — Information about remaining quotas for this connection. Only applicable for customers opted in to use Finch's Data Sync Refresh endpoint (`POST /jobs/automated`). Please contact a Finch representative for more details.
      - `data_sync_all` object
        - `allowed_refreshes` integer
        - `remaining_refreshes` integer
  - `data` AutomatedAsyncJob[], required
    - `job_id` string, uuid, required — The id of the job that has been created.
    - `job_url` string, required — The url that can be used to retrieve the job status
    - `type` 'data_sync_all' | 'w4_form_employee_sync', required — The type of automated job
    - `status` 'pending' | 'in_progress' | 'complete' | 'error' | 'reauth_error' | 'permissions_error', required
    - `created_at` string, date-time, required — The datetime when the job was created. for scheduled jobs, this will be the initial connection time. For ad-hoc jobs, this will be the time the creation request was received.
    - `scheduled_at` string, date-time, nullable, required — The datetime a job is scheduled to be run. For scheduled jobs, this datetime can be in the future if the job has not yet been enqueued. For ad-hoc jobs, this field will be null.
    - `started_at` string, date-time, nullable, required — The datetime a job entered into the job queue.
    - `completed_at` string, date-time, nullable, required — The datetime the job completed.
    - `params` object, nullable, required — The input parameters for the job.
      - `individual_id` string — The ID of the individual that the job was completed for.

## Other responses

- `401` — Unauthorized
- `404` — Not Found

## Changes

- **2025-03-25** `69819ddc6d03` — 1 breaking
  - removed the required property `paging` from the response with the `200` status
- **2025-01-31** `97bf4795deec` — 1 warning, 1 info
  - added the new `w4_form_employee_sync` enum value to the `data/items/type` response property for the response status `200`
  - added the required property `data/items/params` to the response with the `200` status

[Change history](https://skmtc.dev/finch-api/apis/api-reference/changes/jobs/automated/get.md)

---

[API](https://skmtc.dev/finch-api/apis/api-reference.md) · [All operations](https://skmtc.dev/finch-api/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/finch-api/api-reference/revisions/ff61a38530df/schema)