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

## Changes

- **2025-10-27** `0105d239fcaf` — 1 warning
  - deleted the `query` request parameter `entity_id`
- **2025-08-18** `e8b684dbd61d` — 1 info
  - added the new optional `query` request parameter `entity_id`
- **2025-04-22** `46640c1b4688` — 1 info
  - the endpoint scheme security `bearerAuth` was added to the API
- **2025-01-31** `97bf4795deec` — 1 warning, 1 info
  - added the new `w4_form_employee_sync` enum value to the `type` response property for the response status `200`
  - added the required property `params` to the response with the `200` status

[Change history](https://skmtc.dev/finch-api/apis/api-reference/changes/jobs/automated/:job_id/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/f1cca2cb0ef2/schema)