---
title: "Retrieve an Automated Job"
method: GET
path: "/jobs/automated/{job_id}"
tags: ["Management"]
---

# Retrieve an Automated Job

`GET /jobs/automated/{job_id}`

Get an automated job by `job_id`.

## Headers

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

## Response `200`

OK

- AutomatedAsyncJob
  - `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

- `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/versions/844e1a4ed34f/schema)