---
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
  - Paging, required
    - `count` integer — The total number of elements for the entire query (not just the given page)
    - `offset` integer, required — The current start index of the returned list of elements
  - `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

---

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